ToAPIs
    homeToAPIs
    모델모델 요금API 문서
    로그인무료로 시작하기

    Quick Answer

    • 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.

    Key Parameters

    • model | string | required | suno | - | Model identifier. Use the fixed value `suno`.
    • prompt | string | required | - | - | Main instruction describing the subject, action, scene, and style.
    • aspect_ratio | string | optional | 16:9 | 16:9 | 9:16 | 1:1 | Video aspect ratio. Defaults to `16:9`; supports `16:9 | 9:16 | 1:1`.
    • duration | integer | optional | 6 | 5 | 10 | 15 | 20 | Output duration in seconds. Defaults to `6`; supports `5 | 10 | 15 | 20`.
    • resolution | string | optional | 720P | 720P | Output resolution. Defaults to `720P`; supports `720P`.

    Common Errors

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

    Model Guide

    suno

    suno is provided by Unknown with Audio capabilities. Current pricing reference: 10 크레딧 /request. This page helps you understand positioning, parameters, and production-ready use cases before integration.

    Vendor

    Unknown

    Modalities

    Audio

    Price

    10 크레딧 /request

    Updated

    2026-10-30

    Open in PlaygroundDocs

    Model ID

    suno

    Model Overview

    Quick Answer

    • 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.

    suno Model Features

    Core Section

    Core capabilities and practical engineering value

    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.

    How to Use suno API

    1. Fill prompt and key parameters.
    2. Run, inspect output structure, then iterate.
    3. Move stable settings into production API.

    Key Parameters

    ParameterTypeRequiredDefaultRangeDescription
    modelstringYessuno-Model identifier. Use the fixed value `suno`.
    promptstringYes--Main instruction describing the subject, action, scene, and style.
    aspect_ratiostringNo16:916:9 | 9:16 | 1:1Video aspect ratio. Defaults to `16:9`; supports `16:9 | 9:16 | 1:1`.
    durationintegerNo65 | 10 | 15 | 20Output duration in seconds. Defaults to `6`; supports `5 | 10 | 15 | 20`.
    resolutionstringNo720P720POutput resolution. Defaults to `720P`; supports `720P`.

    Common Errors

    400 invalid_request_error

    Trigger: Request payload misses required fields or has invalid field types.

    Fix: Validate model, mode, and input schema before request.

    Retry: Retry only after fixing payload; avoid blind retries.

    401 authentication_error

    Trigger: Missing Authorization header or invalid API key.

    Fix: Verify Bearer token format and API key scope.

    Retry: Retry after auth fix; rotate key if repeated failures continue.

    429 rate_limit_exceeded

    Trigger: Request rate, concurrency, or current quota hits upstream rate limiting.

    Fix: Apply exponential backoff first, then review request rate, concurrency, and quota usage.

    Retry: Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.

    500 internal_error

    Trigger: Transient upstream error or internal processing failure.

    Fix: Capture request id and trigger retry workflow.

    Retry: Retry 2-3 times with short delays; escalate if persistent.

    FAQ

    When should I use suno?

    Use it to validate video concepts quickly, compare mode behavior, and converge prompts before API rollout.

    How do I choose Text-to-Video vs Image-to-Video?

    Use Text-to-Video when you only have instructions; use Image-to-Video when you already have key frames or composition.

    What is the difference between R2V and Video Edit?

    R2V focuses on reference-guided generation, while Video Edit focuses on modifying existing video assets.

    Image or video model error: invalid apitype: -1

    This usually means the request was sent to the wrong endpoint. Image and video models typically do not use the chat endpoint. Instead, submit the documented HTTP task request and poll the task status endpoint for results. Check the actual request code, URL, and payload first.

    An image or video task failed, but the user was still charged

    Ask the user for the task log or screenshot first and check whether input or output token usage appears. If token accounting shows up, the request was likely sent through a chat endpoint instead of the proper media workflow. Image and video models usually run as async HTTP task APIs: submit the task first, then poll by task id according to the relevant docs.

    ToAPIs
    homeToAPIs

    엔터프라이즈 AI API 게이트웨이. 텍스트, 이미지, 동영상, 오디오 모델을 하나의 인터페이스로 제공합니다.

    运营主体：
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    注册地址：
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    联系方式：
    support@toapis.com

    모델

    • Sora 2 API
    • Veo 3.1 API
    • GPT Image 2 API
    • 전체 모델

    대안

    • Fal.ai 대안
    • Wavespeed AI 대안
    • PiAPI 대안
    • CometAPI 대안
    • Replicate 대안
    • AIMLAPI 대안

    리소스

    • 문서
    • 서비스 상태
    • 요금
    • 개인정보처리방침
    • 이용약관
    • 이용 정책
    • 데이터 삭제 정책
    • 데이터 보존 정책
    • 하위 처리자 및 데이터 리전
    • 결제 및 환불
    • 쿠키 정책
    • 사이트맵
    • 소개

    © 2026 ToAPIs. All rights reserved.

    지금 시작할 준비가 되셨나요?

    무료로 가입하고 엔터프라이즈급 AI API 게이트웨이의 강력함을 경험해 보세요

    무료로 시작하기요금 보기