TokenLab

Âm nhạc

Lấy trạng thái âm nhạc

Truy xuất trạng thái và kết quả của một tác vụ tạo âm nhạc

GET
/v1/tasks/{id}

GET /v1/music/generations/{id} là một endpoint tương thích. Nó vẫn được hỗ trợ cho các tích hợp hiện có. Các tích hợp mới nên thực hiện poll GET /v1/tasks/{id}; xem Lấy trạng thái tác vụ.

Gọi GET /v1/tasks/{id} để kiểm tra trạng thái tác vụ tạo âm nhạc của bạn.

id và task_id xác định cùng một tác vụ.

Một tác vụ công khai đã hết hạn hoặc không khả dụng có thể trả về 404 async_task_not_found. Nếu không thể xác định quyền sở hữu tác vụ cho API key hiện tại, phản hồi sẽ là 403 task_not_owned.

Tham số đường dẫn (Path Parameters)

idstringpathbắt buộc

ID của tác vụ tạo âm nhạc.

Phản hồi (Response)

idstring

ID của tác vụ.

task_idstring

Bí danh của cùng một ID tác vụ bất đồng bộ, khi được trả về.

poll_urlstring

URL trạng thái cho tác vụ này. Hãy poll GET /v1/tasks/{id} với id.

statusstring

Trạng thái tác vụ: pending, processing, completed, failed, hoặc timeout. Một tác vụ thất bại vẫn trả về HTTP 200.

progressinteger

Giá trị tiến trình tùy chọn. Chỉ được trả về khi có giá trị tiến trình thực tế; hãy sử dụng status để xác định việc hoàn thành.

Các trường kết quả phụ thuộc vào thao tác. Âm nhạc có thể trả về audio_url và audio_id; các tác vụ chỉ có lời bài hát trả về lyrics; tách âm thanh có thể trả về nhiều tệp trong data. video_url, tiêu đề, tiến trình và các siêu dữ liệu khác là tùy chọn. Hãy kiểm tra status để biết trạng thái hoàn thành và đọc các trường thực tế được trả về.

audio_idstring

ID âm thanh nguồn tùy chọn, có thể sử dụng cùng với ID của tác vụ này trong các thao tác tiếp theo được hỗ trợ.

dataarray

Mảng đầu ra tùy chọn, bao gồm các tệp âm thanh đã tách với audio_url hoặc url.

audio_urlstring

URL để tải xuống tệp âm thanh (khi hoàn tất). Một liên kết kết quả phương tiện của TokenLab có hiệu lực trong 30 ngày.

video_urlstring

URL đến phiên bản video có trình hiển thị hình ảnh (khi hoàn tất và được trả về cho mô hình).

image_urlstring

URL ảnh bìa, khi mô hình trả về một ảnh.

titlestring

Tiêu đề bài hát đã tạo.

lyricsstring

Lời bài hát đã tạo hoặc được cung cấp.

errorstring | object

Thông báo lỗi (khi thất bại).

error_detailsobject

Chi tiết lỗi khi tác vụ thất bại: status, message, type, code, retryable, và param khi một trường yêu cầu bị lỗi.

media_retentionobject

Trạng thái lưu trữ của các liên kết kết quả: days và items[] với url, kind, status, và expires_at. Nó có thể không xuất hiện; các liên kết vẫn hoạt động. Xem Lưu trữ dữ liệu.

Yêu cầu

curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

Phản hồi

Phản hồi (Đã hoàn thành)
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "completed",
  "audio_url": "https://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
  "title": "Night Drive",
  "lyrics": "[Verse 1]\nDriving through the night...",
  "audio_id": "audio_abc123",
  "media_retention": {
    "days": 30,
    "items": [
      {
        "url": "https://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
        "kind": "audio",
        "content_type": "audio/mpeg",
        "status": "saved",
        "expires_at": "2024-02-22T08:54:20.000Z"
      }
    ]
  }
}

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Tham số đường dẫn

id*string

ID tác vụ async được trả về bởi id / task_id, hoặc được nhúng trong poll_url

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json