suno API Руководство по модели

Краткий вывод

suno supports Text-to-Video, Image-to-Video, R2V, and Video Edit in one workflow.
Use this model guide page to validate parameters with minimal request/response examples.
Stabilize prompts here first, then move to production API integration.

Ключевые возможности

Unified multi-mode testing：Switch across Text-to-Video, Image-to-Video, R2V, and Video Edit in one place.
Parameter-first validation：Iterate quickly on prompts, durations, and references before production rollout.
Production-ready handoff：Minimal request/response structure helps you move stable configs into API workflows.

Когда использовать

When you need fast iteration across multiple generation modes.
When you need to validate parameters and error handling before integration.

Когда не использовать

For large-scale async batch production, use the server-side API pipeline directly.
For strict auth/audit requirements, prioritize backend orchestration.

Особенности работы

This model guide page is optimized for interaction and parameter rehearsal.
The output panel demonstrates task result structure for integration guidance.

Минимальный запрос

{
  "model": "suno",
  "mode": "text-to-video",
  "input": {
    "prompt": "A cinematic city sunrise with soft fog and moving traffic.",
    "duration": 5
  }
}

Минимальный ответ

{
  "task_id": "task_xxxxxxxx",
  "model": "suno",
  "mode": "text-to-video",
  "status": "queued",
  "created_at": "2026-04-15T00:00:00.000Z"
}

model	string	Да	suno	-	Model identifier. Use the fixed value `suno`.
prompt	string	Да	-	-	Main instruction describing the subject, action, scene, and style.
aspect_ratio	string	Нет	16:9	16:9	9:16
duration	integer	Нет	6	5	10
resolution	string	Нет	720P	720P	Output resolution. Defaults to `720P`; supports `720P`.

400	invalid_request_error	Request payload misses required fields or has invalid field types.	Validate model, mode, and input schema before request.	Retry only after fixing payload; avoid blind retries.
401	authentication_error	Missing Authorization header or invalid API key.	Verify Bearer token format and API key scope.	Retry after auth fix; rotate key if repeated failures continue.
429	rate_limit_exceeded	Request rate, concurrency, or current quota hits upstream rate limiting.	Apply exponential backoff first, then review request rate, concurrency, and quota usage.	Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.
500	internal_error	Transient upstream error or internal processing failure.	Capture request id and trigger retry workflow.	Retry 2-3 times with short delays; escalate if persistent.

suno Полный разбор (Markdown)

suno API Руководство по модели

Краткий вывод

Ключевые возможности

Когда использовать

Когда не использовать

Особенности работы

Минимальный запрос

Минимальный ответ

Ключевые параметры

Частые ошибки

FAQ

Связанные API