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": "nano_banana_pro",
    "params": {
      "prompt": "Professional level city nightscape",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "format": "png"
    },
    "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.When using, add to the request header:
Authorization: Bearer YOUR_API_KEY

​
Body

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

​
Response

​
task_id
string
Task ID, used to query 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 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": "nano_banana_pro",
    "params": {
      "prompt": "Professional level city nightscape",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "format": "png"
    },
    "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"
  }
}