Validation phrase

Model id ai-music-api/validation-phrase. Create a task, then poll it. The playground on the Suno model page sends the same fields.

Create a task

POST https://modelfold.ai/api/v1/jobs/createTask

bash

curl https://modelfold.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"ai-music-api/validation-phrase","input":{"vocal_start_s":0,"vocal_end_s":5}}'

const created = await fetch('https://modelfold.ai/api/v1/jobs/createTask', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + process.env.MODELFOLD_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({"model":"ai-music-api/validation-phrase","input":{"vocal_start_s":0,"vocal_end_s":5}}),
}).then((r) => r.json())

A synchronous call is also accepted at POST https://modelfold.ai/v1/audio/generations with the same JSON body flattened (model plus the input fields). Long songs should use the jobs API.

Parameters

Field	Type	Required	Meaning
`voice_url`	string	yes	Voice URL
`vocal_start_s`	number	yes	Vocal start (seconds)
`vocal_end_s`	number	yes	Vocal end (seconds)

Price

Upstream cost 0. This call is free at the current markup.

The markup can be changed in site settings (price_markup). Per-model upstream costs can be overridden with the suno_pricing setting.

Result

GET https://modelfold.ai/api/v1/jobs/recordInfo?taskId=TASK_ID

When state is success, resultJson contains resultUrls (audio, video, MIDI, or a text sidecar) and resultObject.sourceTaskId plus resultObject.tracks[].id. Follow-up calls use that source task id and track id. A failed task is refunded.

Webhook

Optional callBackUrl must be public HTTPS on port 443. callbackSecret is 32 to 256 characters. ModelFold POSTs the event below and signs the raw body. Signature is base64 HMAC-SHA256 of timestamp.eventId.rawBody, sent as X-ModelFold-Signature, with X-ModelFold-Timestamp and X-ModelFold-Event-Id.

json

{
  "event": "task.completed",
  "data": { "taskId": "MODELFOLD_TASK_ID", "model": "ai-music-api/validation-phrase", "state": "success" }
}

More Suno endpoints

Generate song · Extend · Cover · Upload and extend · Add instrumental · Add vocals · Mashup · Separate vocals · Replace section · Sound effect · Music video · Timestamped lyrics · Lyrics · Boost style · Convert to WAV · Recover audio · Cover image · Persona · MIDI · Create voice · Check voice · Regenerate phrase

Validation phrase ​

Create a task ​

Parameters ​

Price ​

Result ​

Webhook ​