Skip to main content
POST
generate standalone image
Submit a standalone image generation job. Poll Get Task Status until success.

Credits

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:
The service polls the Suno batch internally until items are complete, so the task result already contains image_url values.

Example

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"