POST /generate

Callback endpoint for receiving generation results.

POSThttps://udioapi.pro/api/generate

tips

This endpoint receives callbacks when generation tasks are completed.

Callback URL Requirements:

  • Must be publicly accessible (no localhost, internal IPs, or private networks)
  • Must accept POST requests
  • Will receive an array of generation results in the request body

Callbacks are sent at each stage: text generation, first audio, and completion.

requestHeaders

namerequireddescription
Content-TypeYesapplication/json

responses

[
  {
    "id": "081a452c-45e2-44d2-88cc-15e06fb2544d",
    "audio_url": "",
    "image_url": "https://image_.jpeg",
    "image_large_url": "https://image_0.jpeg",
    "created_at": "2025-08-19T23:07:28.936Z",
    "createTime": "2025-08-19T23:07:28.936Z",
    "timestamp": 1755616048327,
    "status": "text",
    "title": "xxxx",
    "prompt": "xxxxxxxxx",
    "tags": "xxx",
    "duration": "",
    "model_name": "chirp-v3-5",
    "extra_message": "Text generated successfully.",
    "fail_message": "",
    "error_message": ""
  },
  {
    "id": "2a20be9d-c876-45e3-a3ed-867b5bf3c4e6",
    "audio_url": "",
    "image_url": "https://image_.jpeg",
    "image_large_url": "https://image_.jpeg",
    "created_at": "2025-08-19T23:07:28.936Z",
    "createTime": "2025-08-19T23:07:28.936Z",
    "timestamp": 1755616048327,
    "status": "text",
    "title": "xxxx",
    "prompt": "xxxxxxxx",
    "tags": "xxxxx",
    "duration": "",
    "model_name": "chirp-v3-5",
    "extra_message": "Text generated successfully.",
    "fail_message": "",
    "error_message": ""
  }
]
[
  {
    "id": "081a452c-45e2-44d2-88cc-15e06fb2544d",
    "audio_url": "https://xxxx.mp3",
    "image_url": "https://xxxx.jpeg",
    "image_large_url": "https://xxxx.jpeg",
    "created_at": "2025-08-19T23:09:09.050Z",
    "createTime": "2025-08-19T23:09:09.050Z",
    "timestamp": 1755616048327,
    "status": "first",
    "title": "xxxx",
    "prompt": "xxxxx",
    "tags": "xxx",
    "duration": 156.36,
    "model_name": "chirp-v3-5",
    "extra_message": "First audio generated successfully.",
    "fail_message": "",
    "error_message": ""
  },
  {
    "id": "2a20be9d-c876-45e3-a3ed-867b5bf3c4e6",
    "audio_url": "",
    "image_url": "https://xxxx.jpeg",
    "image_large_url": "https://xxxxx.jpeg",
    "created_at": "2025-08-19T23:09:09.050Z",
    "createTime": "2025-08-19T23:09:09.050Z",
    "timestamp": 1755616048327,
    "status": "first",
    "title": "xxxx",
    "prompt": "xxxxxxx",
    "tags": "xxxxx",
    "duration": "",
    "model_name": "chirp-v3-5",
    "extra_message": "First audio generated successfully.",
    "fail_message": "",
    "error_message": ""
  }
]
[
  {
    "id": "94316433-5bf5-4fb2-9285-83e60aaca920",
    "audio_url": "https://xxxx.mp3",
    "image_url": "https://xxx.jpeg",
    "image_large_url": "https://xxx.jpeg",
    "created_at": "2025-08-19T23:20:53.879Z",
    "createTime": "2025-08-19T23:20:53.879Z",
    "timestamp": 1755616853152,
    "status": "complete",
    "title": "xxxx",
    "prompt": "xxxxx",
    "tags": "xxxx",
    "duration": 122,
    "model_name": "chirp-v3-5",
    "extra_message": "All generated successfully.",
    "fail_message": "",
    "error_message": ""
  },
  {
    "id": "8206443a-1bd8-4cfd-8ef2-29c16b25c8b7",
    "audio_url": "https://xxxxx.mp3",
    "image_url": "https://xxxxxx.jpeg",
    "image_large_url": "https://xxxxx.jpeg",
    "created_at": "2025-08-19T23:20:53.879Z",
    "createTime": "2025-08-19T23:20:53.879Z",
    "timestamp": 1755616853152,
    "status": "complete",
    "title": "xxxx",
    "prompt": "xxx",
    "tags": "xxxx",
    "duration": 178.64,
    "model_name": "chirp-v3-5",
    "extra_message": "All generated successfully.",
    "fail_message": "",
    "error_message": ""
  }
]

curlCommand

curl -X POST "https://udioapi.pro/api/generate" \n  -H "Content-Type: application/json"