Skip to main content
POST
/
suno
/
v2
/
image
/
generate
generate standalone image
curl --request POST \
  --url https://api.mountsea.ai/suno/v2/image/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "image_gen_category": "basic"
}
'
{
  "taskId": "15c257ff-43f7-4678-bd41-202ad6b8488b"
}
Submit a standalone image generation job. Poll Get Task Status until success.

​
Credits

image_gen_categoryCost
basic0 credits per image
advancedPer policy (conf_task_policy[image_generate].cost, e.g. 20 credits per image)
Total cost = credits per image × quantity. Quantity is fixed at 2 internally and is not exposed in the API.

​
Result

When the task completes, result includes a batch with two items: 
{
  "taskId": "f45b6bd0-...",
  "result": {
    "batch_id": "xxx",
    "items": [
      { "status": "complete", "image_url": "https://..." },
      { "status": "complete", "image_url": "https://..." }
    ]
  }
}
The service polls the Suno batch internally until items are complete, so the task result already contains image_url values.

​
Example

curl -X POST https://api.mountsea.ai/suno/v2/image/generate \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a futuristic city at sunset",
    "image_gen_category": "advanced"
  }'

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
prompt
string
required

图片生成提示词

​
image_gen_category
enum<string>
default:basic
required

basic = 0 积分；advanced = 按 conf_task_policy[image_generate].cost 扣减

Available options:
basic,
advanced

Response

201 - application/json
​
taskId
string
required

task id. Use this id to query task status.

Example:

"15c257ff-43f7-4678-bd41-202ad6b8488b"