Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
Tổng quan

Sử dụng endpoint này để polling async hợp nhất trên nhiều loại tác vụ như tạo video, hình ảnh, âm nhạc và 3D. Nếu phản hồi create bao gồm poll_url, hãy gọi chính xác path đó. Đối với các workflow async mới hơn, poll_url có thể trỏ tới /v1/tasks/{taskId}.

​
Tham số Đường dẫn

​
taskId
string
bắt buộc
ID tác vụ được trả về từ yêu cầu create.

​
Phản hồi

​
id
string
Định danh tác vụ.
​
status
string
Trạng thái tác vụ như pending, processing, completed hoặc failed. Tác vụ đã hủy được biểu diễn là failed với cancelled: true.
​
cancelled
boolean
true khi một async task đang chờ được hủy trước khi thực thi.
​
cancellation_status
string
Dấu hiệu hủy. Có giá trị cancelled khi hủy thành công.
​
data
array
Với tác vụ hình ảnh đã hoàn tất, kết quả hình ảnh được tạo sẽ được trả về tại đây. Tác vụ hình ảnh trả về URL trong data[].url.
​
video_url
string
URL asset kết quả khi tác vụ hoàn tất và tạo ra một video.
​
error
string
Thông báo lỗi khi tác vụ thất bại.

​
Hành vi lỗi

Nếu tác vụ không còn tồn tại, đã hết hạn hoặc không thể được phân giải thông qua hợp đồng async-task công khai, LemonData sẽ trả về: 
{
  "error": {
    "message": "Task not found or no longer available.",
    "type": "invalid_request_error",
    "code": "async_task_not_found"
  }
}

​
Ví dụ

curl "https://api.lemondata.cc/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
Python
import requests

poll_url = "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
response = requests.get(
    f"https://api.lemondata.cc{poll_url}",
    headers={"Authorization": "Bearer sk-your-api-key"},
)
print(response.json())
JavaScript
const pollUrl = '/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
const response = await fetch(`https://api.lemondata.cc${pollUrl}`, {
  headers: { Authorization: 'Bearer sk-your-api-key' },
});
console.log(await response.json());