Skip to main content
POST
https://test.aireiter.com
/
api
/
openapi
/
submit
curl --request POST \
  --url https://test.aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedream_v4",
    "params": {
      "prompt": "Beautiful sunset by the seaside",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "output_n": "2"
    }
  }'

{
  "statusCode": 200,
  "message": "",
  "data": {
      "task_id": "order_p9EyMzcBxkH7zxQhlnP6k",
      "out_task_id": "my_task_123456",
      "status": "pending",
      "estimated_credits": 100,
      "created_at": "2025-12-22T06:03:28.242Z"
  }
}

​
Authorizations

​
Authorization
string
required
All endpoints require authentication using a Bearer Token.Get the API Key:Visit the API Key management page to get your API Key.Add the following to the request headers when using:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
required
Model NameFixed value: "seedream_v4"
​
params
object
required
Model Parameters Object
​
out_task_id
string
required
Initiator’s Task IDUser-defined task identifier, required
​
callback_url
string
Callback notification URL upon task completionAfter task completion, the system will POST the result notification to this URL
​
metadata
object
Custom metadataReturned as-is when querying results, can be used for business identification

​
Response

​
task_id
string
Task ID, used for querying results
​
out_task_id
string
Initiator’s task ID, can be used to query results
​
status
string
Initial status, fixed as "pending"
​
estimated_credits
number
Estimated credits consumed
​
created_at
string
Creation time (ISO format)
curl --request POST \
  --url https://test.aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedream_v4",
    "params": {
      "prompt": "Beautiful sunset by the seaside",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "output_n": "2"
    }
  }'

{
  "statusCode": 200,
  "message": "",
  "data": {
      "task_id": "order_p9EyMzcBxkH7zxQhlnP6k",
      "out_task_id": "my_task_123456",
      "status": "pending",
      "estimated_credits": 100,
      "created_at": "2025-12-22T06:03:28.242Z"
  }
}