Docs · v1

Rate limits

Generation is metered in credits and input limits. Stay within script, audio, and file caps, and poll status instead of opening parallel generate calls for the same job.

Credit costs

Parameters

Input limits

• Voice script on video generate: max 1,500 characters
• Existing voice_url audio: max 120 seconds
• Custom avatar image or voice file: max 10MB each
• Product-in-Hand Nova V2 audio: max 90 seconds
• Product-in-Hand Omi-Human audio: max 30 seconds
• Veo scenes array: 1–4 scenes

Polling

Video processing time varies. Use the matching status endpoint and wait 5–10 seconds between polls until completed or failed.

JavaScript polling loop

async function waitForVideo(id) {
  for (;;) {
    const response = await fetch(
      `https://app.makeugc.ai/api/platform/video/status?id=${id}`,
      { headers: { "X-Api-Key": process.env.MAKEUGC_API_KEY } },
    );
    const payload = await response.json();
    const state = payload.data?.status;
    if (state === "completed" || state === "failed") return payload;
    await new Promise((resolve) => setTimeout(resolve, 8000));
  }
}

Insufficient credits

400 response

{
  "status": false,
  "message": "Missing image, invalid file type, file too large, or insufficient credits"
}