REST API

Get3W provides a RESTful API for programmatic access to 700+ AI models.

Base URL

https://api.get3w.com/api/v3

Authentication

All requests require an API key in the Authorization header:

Authorization: Bearer ${GET3W_API_KEY}

Get your API key at get3w.com/accesskey. Store it as an environment variable for security.

Basic Workflow

1. Submit a task — Send a POST request with your parameters
2. Get the task ID — Returned in the response
3. Poll for results — Check status until completion
4. Retrieve outputs — Get URLs to generated content

Example Request

# Submit task
curl -X POST 'https://api.get3w.com/api/v3/get3w/flux-dev' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ${GET3W_API_KEY}' \
  -d '{
    "prompt": "A cat wearing a space suit"
  }'

# Get result (use the task ID from response)
curl 'https://api.get3w.com/api/v3/predictions/TASK_ID' \
  -H 'Authorization: Bearer ${GET3W_API_KEY}'

Response Format

Task Submission Response

{
  "code": 200,
  "message": "success",
  "data": {
    "id": "task-abc123",
    "status": "processing",
    "urls": {
      "get": "https://api.get3w.com/api/v3/predictions/task-abc123"
    }
  }
}

Task Result Response

{
  "code": 200,
  "message": "success",
  "data": {
    "id": "task-abc123",
    "status": "completed",
    "outputs": ["https://..."],
    "timings": {
      "inference": 2500
    }
  }
}

Task Status Values

Status	Description
created	Task received
processing	Generation in progress
completed	Success, outputs available
failed	Error occurred

Error Handling

Code	Description
200	Success
400	Bad request (invalid parameters)
401	Unauthorized (invalid API key)
403	Forbidden (account issue)
429	Rate limit exceeded
500	Server error

API Reference

• How to Submit Task
• How to Get Result
• How to Upload Files
• How to Use Webhooks

Next Steps

• How Get3W Works — Understand the platform architecture
• API Authentication — Security best practices