OpenAI-Hub中文文档
首页控制台
首页控制台
  1. 其他接口格式
  • 序言
  • OpenAI接口
    • 聊天通用
      • 如何上传文件?
      • 语音对话接口
      • 聊天(通用)
      • gpts接口
      • gpt-4-all(生成图片)
      • gpt-4-all(分析图片)
    • 内容补全
      • 创建完成
    • 图像接口
      • 创建图像
      • 创建图像编辑
      • 创建图像变化
    • 音频接口
      • 创建语音
      • 创建转录
    • 向量生成
      • 创建嵌入
    • 模型列表
      • 列出模型
    • 内容审核
      • 创建内容审核
    • 帮助中心
      • HTTP接口状态码
  • Suno音乐接口
    • 接口格式(通用)
      • 生成音乐
      • 生成歌词
      • 查询单个任务
      • 批量查询任务
    • 其他接口格式
      • 生成音乐
        POST
      • 查询任务
        GET
  • 绘画接口
    • Midjourney
      • InsightFace任务提交
        • 提交swap_face任务(废弃)
      • 任务提交
        • 提交Imagine任务
        • 执行动作
        • 提交Blend任务
        • 提交Describe任务
        • 提交Modal
        • 提交Shorten任务
        • 上传文件到discord
      • 任务查询
        • 指定ID获取任务
        • 根据ID列表查询任务
        • 根据ID列表查询任务-字段displays
        • 获取任务图片的seed
    • Flux(暂不可用)
      • 生成图片
    • Ideogram(绘画)
      • Generate(文生图)
      • Remix(混合图)
      • Upscale(放大高清)
      • Describe(描述)
  • 视频接口
    • Luma视频接口
      • 官方接口格式
        • 视频生成
        • 获取结果
      • 平台格式
        • 任务提交
          • 生成视频
          • 扩展视频
          • 获取视频无水印链接
        • 任务查询
          • 查询单个任务
          • 批量查询任务
    • Runway视频接口
      • feed
      • generate(文本)
      • generate(参考图片)
    • Pika视频接口
      • 任务提交
      • 查询任务
  • 文本生成(通用)
    • 聊天(通用)
      POST
    • Anthropic Claude(全系列,已更新支持第三代)
      POST
    • gemini-pro
      POST
  • 可灵AI
    • 回调协议
    • 生成图像
      POST
    • 生成视频
      POST
    • 图生视频
      POST
    • 查询单个任务
      GET
  1. 其他接口格式

查询任务

GET
https://api.openai-hub.com/suno/v1/music/{id}
通过任务ID查询任务的状态和结果。

请求参数

Path 参数
id
string 
任务ID
必需
Header 参数
Authorization
string 
必需
在 Header 添加参数 Authorization,其值为在 Bearer 之后拼接 令牌
示例
Authorization: Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379
默认值:
Bearer {{YOUR_API_KEY}}
Content-Type
string 
可选
默认值:
application/json

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.openai-hub.com/suno/v1/music/' \
--header 'Authorization;' \
--header 'Content-Type: application/json'

返回响应

🟢200成功
application/json
Body
code
integer 
可选
示例值:
200
data
object 
可选
task_id
string 
可选
示例值:
56ea8da3-8507-4118-9f1e-111111111111
status
string 
可选
示例值:
completed
input
string 
可选
示例值:
{"custom_mode":false,"gpt_description_prompt":"blowing in the wind","make_instrumental":false,"prompt":"","title":"","continue_at":0,"continue_clip_id":"","mv":"chirp-v3-0","tags":""}
clips
object 
可选
message
string 
可选
示例值:
success
示例
{
    "code": 200,
    "data": {
        "task_id": "56ea8da3-8507-4118-9f1e-111111111111",
        "status": "completed",
        "input": "{\"custom_mode\":false,\"gpt_description_prompt\":\"blowing in the wind\",\"make_instrumental\":false,\"prompt\":\"\",\"title\":\"\",\"continue_at\":0,\"continue_clip_id\":\"\",\"mv\":\"chirp-v3-0\",\"tags\":\"\"}",
        "clips": {
            "e0fe8bba-fac8-460b-bf1c-111111111111": {
                "id": "e0fe8bba-fac8-460b-bf1c-111111111111",
                "video_url": "https://cdn1.suno.ai/e0fe8bba-fac8-460b-bf1c-111111111111.mp4",
                "audio_url": "https://cdn1.suno.ai/e0fe8bba-fac8-460b-bf1c-111111111111.mp3",
                "image_url": "https://cdn1.suno.ai/image_e0fe8bba-fac8-460b-bf1c-111111111111.png",
                "image_large_url": "https://cdn1.suno.ai/image_large_e0fe8bba-fac8-460b-bf1c-111111111111.png",
                "is_video_pending": false,
                "major_model_version": "v3",
                "model_name": "chirp-v3",
                "metadata": {
                    "tags": "acoustic folk ballad",
                    "prompt": "[Verse]\nLeaves whisper\nTrees sway\nIn the wind\nWe all play\nQuestions fly\nAnswers hide\nIn this world\nSide by side\n\n[Verse 2]\nBirds soar\nClouds roam\nIn the breeze\nWe find home\nSearching for truth\nIn the sky\nAs the wind carries our sigh\n\n[Chorus]\nBlowin' in the breeze\nWe're like the leaves\nWonderin' where life takes us\nWhere it leads\nWith every gust\nWe let go of what we know\nBlowin' in the breeze\nWe're free to grow",
                    "gpt_description_prompt": "blowing in the wind",
                    "audio_prompt_id": "",
                    "history": null,
                    "concat_history": null,
                    "type": "gen",
                    "duration": 108.8,
                    "refund_credits": false,
                    "stream": true,
                    "error_type": null,
                    "error_message": null
                },
                "is_liked": false,
                "is_handle_updated": false,
                "is_trashed": false,
                "reaction": null,
                "created_at": "2024-04-18T14:29:31.760Z",
                "status": "complete",
                "title": "Blowin' in the Breeze",
                "play_count": 0,
                "upvote_count": 0,
                "is_public": false
            },
            "f66f7a6f-a868-464f-b280-111111111111": {
                "id": "f66f7a6f-a868-464f-b280-111111111111",
                "video_url": "https://cdn1.suno.ai/f66f7a6f-a868-464f-b280-111111111111.mp4",
                "audio_url": "https://cdn1.suno.ai/f66f7a6f-a868-464f-b280-111111111111.mp3",
                "image_url": "https://cdn1.suno.ai/image_f66f7a6f-a868-464f-b280-111111111111.png",
                "image_large_url": "https://cdn1.suno.ai/image_large_f66f7a6f-a868-464f-b280-111111111111.png",
                "is_video_pending": false,
                "major_model_version": "v3",
                "model_name": "chirp-v3",
                "metadata": {
                    "tags": "acoustic folk ballad",
                    "prompt": "[Verse]\nLeaves whisper\nTrees sway\nIn the wind\nWe all play\nQuestions fly\nAnswers hide\nIn this world\nSide by side\n\n[Verse 2]\nBirds soar\nClouds roam\nIn the breeze\nWe find home\nSearching for truth\nIn the sky\nAs the wind carries our sigh\n\n[Chorus]\nBlowin' in the breeze\nWe're like the leaves\nWonderin' where life takes us\nWhere it leads\nWith every gust\nWe let go of what we know\nBlowin' in the breeze\nWe're free to grow",
                    "gpt_description_prompt": "blowing in the wind",
                    "audio_prompt_id": "",
                    "history": null,
                    "concat_history": null,
                    "type": "gen",
                    "duration": 103.2,
                    "refund_credits": false,
                    "stream": true,
                    "error_type": null,
                    "error_message": null
                },
                "is_liked": false,
                "is_handle_updated": false,
                "is_trashed": false,
                "reaction": null,
                "created_at": "2024-04-18T14:29:31.761Z",
                "status": "complete",
                "title": "Blowin' in the Breeze",
                "play_count": 0,
                "upvote_count": 0,
                "is_public": false
            }
        }
    },
    "message": "success"
}
修改于 2024-09-09 06:08:49
上一页
生成音乐
下一页
提交swap_face任务(废弃)
Built with