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": "gpt_4o",
    "params": {
      "prompt": "An ancient castle under the starry sky",
      "aspect_ratio": "1:1"
    },
    "out_task_id": "my_task_123456"
  }'

{
  "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 obtain your API Key.Add the following to the request headers:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
required
Model nameFixed value: "gpt_4o"
​
params
object
required
Model parameters object
​
out_task_id
string
required
Initiator task IDUser-defined task identifier, required
​
callback_url
string
Callback URL for task completion notificationAfter task completion, the system will send a POST request to this URL to notify the result
​
metadata
object
Custom metadataReturned as-is in query results, can be used for business identification

​
Response

​
task_id
string
Task ID, used to query the result
​
out_task_id
string
Initiator’s task ID, can be used to query the result
​
status
string
Initial status, fixed as "pending"
​
estimated_credits
number
Estimated credit consumption
​
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": "gpt_4o",
    "params": {
      "prompt": "An ancient castle under the starry sky",
      "aspect_ratio": "1:1"
    },
    "out_task_id": "my_task_123456"
  }'

{
  "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"
  }
}