Skip to main content
POST
/
queue
/
submit
cURL
curl -X POST https://api.together.ai/v1/queue/submit \
  -H "Authorization: Bearer $TOGETHER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "my-org/video-generator",
    "payload": {"prompt": "A cat playing piano", "duration": 5},
    "priority": 1,
    "info": {"user_id": "user_123"}
  }'
{
  "requestId": "019ba379-92da-71e4-ac40-d98059fd67c7",
  "status": "pending"
}

Authorizations

​
Authorization
string
header
default:default
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Job request

​
model
string
required

Required model identifier

​
payload
object
required

Freeform model input. Passed unchanged to the model. Contents are model-specific.

​
info
object

Arbitrary JSON metadata stored with the job and returned in status responses. The model and system may add or update keys during processing.

​
priority
integer
default:0

Job priority. Higher values are processed first (strict priority ordering). Jobs with equal priority are processed in submission order (FIFO).

Response

Successfully queued request

​
error
object
​
requestId
string

Unique identifier for the submitted job. Use this to poll status or cancel.