批量获取任务
接口：POST /suno/fetch 归属：音频接口/Suno文生歌 调用地址：Base URL https://api.allyang.cn（OpenAI 兼容前缀 https://api.allyang.cn/v1）+ 上述路径 鉴权：请求头 Authorization: Bearer <你的令牌>；令牌在控制台「令牌管理」创建 说明：下方为本接口契约。路径、字段名与枚举取值与线上接口一致；叙述文字已按本平台口径重写。价格、并发与限流等数值以控制台及实际返回为准，未确认处标注「待补」。
OpenAPI Specification
yaml
openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/suno/fetch:
post:
summary: 批量获取任务
description: ''
tags:
- 音频接口/Suno文生歌
parameters:
- name: Accept
in: header
description: ''
required: false
example: application/json
schema:
type: string
- name: Content-Type
in: header
description: ''
required: false
example: application/json
schema:
type: string
- name: Authorization
in: header
description: ''
required: false
example: Bearer {{YOUR_API_KEY}}
schema:
type: string
default: Bearer {{YOUR_API_KEY}}
requestBody:
content:
application/json:
schema:
type: object
properties:
ids:
type: array
items:
type: string
description: "task_id 列表。"
action:
type: string
description: "操作类型：MUSIC、LYRICS。"
required:
- ids
examples: {}
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties:
code:
type: string
message:
type: string
data:
type: array
items:
type: object
properties:
task_id:
type: string
notify_hook:
type: string
action:
type: string
status:
type: string
fail_reason:
type: string
submit_time:
type: integer
start_time:
type: integer
finish_time:
type: integer
progress:
type: string
data:
type: array
items:
type: object
properties:
id:
type: string
title:
type: string
status:
type: string
metadata:
type: object
properties:
tags:
type: string
prompt:
type: string
duration:
type: 'null'
error_type:
type: 'null'
error_message:
type: 'null'
audio_prompt_id:
type: 'null'
gpt_description_prompt:
type: string
required:
- tags
- prompt
- duration
- error_type
- error_message
- audio_prompt_id
- gpt_description_prompt
audio_url:
type: string
image_url:
type: string
video_url:
type: string
model_name:
type: string
image_large_url:
type: string
major_model_version:
type: string
required:
- id
- title
- status
- metadata
- audio_url
- image_url
- video_url
- model_name
- image_large_url
- major_model_version
01HYA5E4C7JK3Z54KZC15MT6MF:
type: string
01HYA5E6591BRCC6W1VDFB5XSM:
type: string
01HYA5E6J1YHDJZ55GGES1YCQA:
type: string
01HYA5E6WS1W6XE3WSZ1QDQMS8:
type: string
01HYA5E731PEJDJP7HS4YBQBG0:
type: string
01HYA5E7FTPXEFSXWHT2PKBY79:
type: string
required:
- 01HYA5E4C7JK3Z54KZC15MT6MF
- 01HYA5E6591BRCC6W1VDFB5XSM
- 01HYA5E6J1YHDJZ55GGES1YCQA
- 01HYA5E6WS1W6XE3WSZ1QDQMS8
- 01HYA5E731PEJDJP7HS4YBQBG0
- 01HYA5E7FTPXEFSXWHT2PKBY79
required:
- code
- message
- data
headers: {}
security: []
components:
schemas: {}
securitySchemes: {}
servers: []
security: []