Roko API
控制台

文件

Suno V5.5 API 開發指南

Suno V5.5 目前狀態為「已上線」。本指南提供開發接入所需的模型 ID、價格快照與可複製範例。 Suno V5.5 模型頁

簡介

  • 供應商: Suno
  • 類型: 音訊
  • 規格數: 1
  • 端點標籤: audio-task

可用規格與價格

請求中的 model 必須使用下表中的模型 ID，並注意大小寫。

規格 模型 ID 單次價格 輸出 上下文
Suno V5.5 suno-v5.5 $0.0600 / 次 — —

價格為建置時快照；最新售價以定價頁和控制台為準。

Base URL 與驗證

Base URL 為 https://api.rokoapi.com/v1。所有請求都必須攜帶 Authorization: Bearer $OPENAI_API_KEY。

控制台

快速開始

curl https://api.rokoapi.com/v1/audios/tasks \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "suno-v5.5",
  "prompt": "輕快的夏日流行歌曲，女聲，帶有明亮的吉他"
}'

常用參數

參數說明
model使用上表中的公開模型 ID。
prompt / messages輸入提示詞、對話訊息或生成指令，具體格式取決於端點。
metadata.custom生成模型可依據模型功能傳入尺寸、畫質、時長、長寬比或參考素材 URL。
prompt生成模型可依據模型功能傳入尺寸、畫質、時長、長寬比或參考素材 URL。
metadata.title生成模型可依據模型功能傳入尺寸、畫質、時長、長寬比或參考素材 URL。
metadata.tags生成模型可依據模型功能傳入尺寸、畫質、時長、長寬比或參考素材 URL。
metadata.instrumental生成模型可依據模型功能傳入尺寸、畫質、時長、長寬比或參考素材 URL。
duration生成模型可依據模型功能傳入尺寸、畫質、時長、長寬比或參考素材 URL。
metadata.negative_tags生成模型可依據模型功能傳入尺寸、畫質、時長、長寬比或參考素材 URL。

非同步生成任務提交成功後會返回任務 ID。請呼叫 GET /v1/tasks/{task_id} 查詢，直到狀態變為 completed 或 failed。

注意事項

  • 僅使用本頁列出的模型 ID；未啟用或已下線的名稱會返回模型不可用錯誤。
  • 遇到 403 時，請檢查帳戶餘額、金鑰分組與模型存取權限。
  • 多模態、工具呼叫、快取與串流功能取決於上游模型及通道設定，請以實際回應為準。