Hình ảnh, video, nhạc và giọng nói
Khóa bạn dùng cho văn bản cũng tạo ra hình ảnh, video, nhạc và giọng nói, và chuyển đổi bản ghi âm thành văn bản, từ cùng một số dư. Chọn một mô hình trong bảng mô hình (hoặc ?type=image, ?type=music, ?type=audio); trang của mỗi mô hình hiển thị giá, loại và một yêu cầu hoạt động.
| Bạn muốn | Route | Ảnh nguồn đi vào |
|---|---|---|
| Một hình ảnh mới từ một prompt | POST /v1/images/generations |
(không có) |
| Một bức ảnh đã chỉnh sửa | POST /v1/images/edits |
image (hoặc image_url, input_images, images) |
| Một video từ một prompt | POST /v1/video/generations |
(không có) |
| Một video bắt đầu từ một bức ảnh | POST /v1/video/generations |
image_url (khung hình đầu tiên); end_image_url cho khung hình cuối cùng |
| Một video từ các ảnh tham chiếu | POST /v1/video/generations |
input_images với "role": "reference" |
| Một câu trả lời văn bản về một bức ảnh | POST /v1/chat/completions |
một phần image_url trong messages[].content |
| Nhạc | POST /v1/music/generations |
(không có) |
| Giọng nói từ văn bản | POST /v1/audio/speech |
(không có) |
| Văn bản từ một bản ghi âm | POST /v1/audio/transcriptions |
(không có; bản ghi âm đi vào file) |
Một ảnh nguồn là một liên kết https://, một URI data: (data:image/png;base64,iVBORw0…) hoặc base64 thuần túy của PNG, JPEG hoặc WebP, tối đa 8 cho mỗi yêu cầu. Các route hình ảnh cũng chấp nhận tải lên đa phần (xem bên dưới). Các liên kết phải là liên kết https:// công khai; các liên kết http:// bị từ chối. Một liên kết chuyển hướng (ví dụ https://picsum.photos/640/360) sẽ được theo dõi, tối đa 5 lần và chỉ đến các liên kết https:// công khai khác, và mô hình sẽ nhận được liên kết cuối cùng. Một liên kết không dẫn đến hình ảnh, hoặc chuyển hướng đến nơi chúng tôi không thể sử dụng, sẽ bị từ chối với 400 invalid_image_url trước khi bất kỳ thứ gì được giữ hoặc tính phí. Hình ảnh gửi nội tuyến làm cho yêu cầu lớn hơn: giữ nó dưới 10 MB, hoặc gửi liên kết.
Trong một tin nhắn trò chuyện (image_url trong messages[].content), một liên kết (https:// hoặc http://) được MartLLM mở và gửi đến mô hình dưới dạng URL data:, vì hầu hết các mô hình thị giác chỉ chấp nhận định dạng đó. Mỗi hình ảnh có thể lên đến 20 MB (40 MB cho mỗi yêu cầu), và các chuyển hướng được theo dõi tối đa 5 lần, chỉ đến các địa chỉ công khai. Các mô hình Gemini nhận liên kết nguyên trạng. Một liên kết không dẫn đến hình ảnh sẽ bị từ chối với 400 invalid_image_url, và không có gì được tính phí.
Tạo ảnh
Ảnh sẽ được trả về trong câu trả lời.
curl https://api.martllm.com/v1/images/generations \
-H "Authorization: Bearer $UBERLLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "venice/z-image-turbo", "prompt": "a red apple on a white table", "n": 1, "size": "1024x1024"}'
{ "created": 1792429247, "data": [{ "url": "https://api.martllm.com/v1/media/artifacts/<id>/0" }],
"usage": { "cost_usd": 0.0099, "max_cost_usd": 0.0109 } }
usage.cost_usd là chi phí của bức ảnh (cũng có trong tiêu đề X-UberLLM-Cost-USD). Trong những trường hợp hiếm hoi mà giá chưa được biết, nó là null. Bạn trả theo phí mà nhà cung cấp đã tính, không bao giờ nhiều hơn max_cost_usd, số tiền đã được giữ cho nó.
Theo mặc định, response_format là url, áp dụng cho cả /v1/images/generations và /v1/images/edits. Hãy gửi "response_format": "b64_json" để nhận ảnh trực tiếp trong câu trả lời. Khi mô hình trả về ảnh, MartLLM sẽ lưu nó dưới dạng tệp trong tài khoản của bạn trong 24 giờ và trả lời bằng liên kết của ảnh (https://api.martllm.com/v1/files/file_…/content), liên kết này cũng có thể dùng làm ảnh gốc để chỉnh sửa sau này. Tải xuống một url với cùng khóa:
curl -L -o image.png -H "Authorization: Bearer $UBERLLM_API_KEY" \
"https://api.martllm.com/v1/media/artifacts/<id>/0"
n là 1 đến 10.
Chỉnh sửa ảnh
Sử dụng một mô hình có chức năng chỉnh sửa (ID của nó thường kết thúc bằng -edit) và gửi ảnh gốc trong image:
curl https://api.martllm.com/v1/images/edits \
-H "Authorization: Bearer $UBERLLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "google/nano-banana-pro-edit", "prompt": "make the sky a sunset",
"image": "https://example.com/skyline.png"}'
Bạn có thể gửi ảnh tương tự dưới các dạng sau:
"image": "data:image/png;base64,iVBORw0…""image_url": "https://…""input_images": ["https://…", "https://…"]: ảnh đầu tiên là ảnh cần chỉnh sửa, phần còn lại là ảnh tham chiếu. Một mục cũng có thể là{"url": "…", "role": "reference"}."images": [{"image_url": "https://…"}], định dạng mà các SDK của OpenAI gửi
Base64 thuần túy cũng hoạt động, và "input_image" được đọc là "image".
Hoặc tải tệp lên, tương tự như cách chỉnh sửa ảnh của OpenAI:
curl https://api.martllm.com/v1/images/edits \
-H "Authorization: Bearer $UBERLLM_API_KEY" \
-F model=google/nano-banana-pro-edit -F prompt="make the sky a sunset" \
-F [email protected]
Yêu cầu chỉnh sửa không có ảnh gốc sẽ bị từ chối với 400 image_required. Mặt nạ (inpainting) không được hỗ trợ.
Tải ảnh lên một lần
Tải một hình ảnh lên /v1/files và sử dụng nó trong bao nhiêu yêu cầu tùy thích trong 24 giờ, thay vì gửi nó trong mỗi yêu cầu:
curl https://api.martllm.com/v1/files \
-H "Authorization: Bearer $UBERLLM_API_KEY" \
-F [email protected]
{ "id": "file_3f9c…", "object": "file", "bytes": 482113, "content_type": "image/png",
"filename": "skyline.png", "created_at": 1792540800, "expires_at": 1792627200,
"url": "https://api.martllm.com/v1/files/file_3f9c…/content" }
Sau đó đặt ID, hoặc url, vào bất cứ đâu cần ảnh nguồn: "image": "file_3f9c…",
"image": {"file_id": "file_3f9c…"}, "image_url": "file_3f9c…", một mục nhập của
input_images, hoặc khung hình bắt đầu của video. Chỉ tài khoản của bạn mới có thể sử dụng các tệp của nó.
- PNG, JPEG, WebP, GIF, HEIC hoặc AVIF, tối đa 10 MB mỗi tệp, tối đa 500 tệp được giữ cho mỗi tài khoản cùng một lúc.
- Được giữ trong 24 giờ, sau đó bị xóa.
GET /v1/files/{id}mô tả một tệp,GET /v1/files/{id}/contenttải xuống tệp đó,DELETE /v1/files/{id}xóa tệp đó ngay bây giờ.
Tạo video
Một video mất một phút hoặc hơn, vì vậy đây là một công việc: bắt đầu, kiểm tra và tải xuống.
1. Bắt đầu
curl https://api.martllm.com/v1/video/generations \
-H "Authorization: Bearer $UBERLLM_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"model": "fal-ai/vidu/q3/text-to-video/turbo", "prompt": "a red ball bouncing on green grass",
"duration_seconds": 5, "models": ["fal-ai/kling-video/v3/standard/text-to-video"]}'
models là tùy chọn: các mô hình dự phòng được thử theo thứ tự chỉ khi mô hình đầu tiên hiện không có nhà cung cấp miễn phí, để một thời điểm bận rộn không làm hỏng yêu cầu của bạn (xem Mô hình dự phòng). Video trên mất khoảng một phút và có giá khoảng $0.33.
Để bắt đầu từ một bức ảnh, hãy sử dụng mô hình chuyển ảnh thành video và thêm image_url:
-d '{"model": "bytedance/seedance-2-0-image-to-video", "prompt": "slow push-in as the waves roll",
"image_url": "https://example.com/first-frame.png", "duration_seconds": 5}'
Một mô hình pha trộn hai bức ảnh cũng cần end_image_url (khung hình cuối cùng). Một mô hình chuyển ảnh thành video hoặc chuyển tham chiếu thành video không thể tạo video chỉ từ văn bản sẽ bị từ chối với 400 image_required khi yêu cầu không có ảnh, trước khi có bất kỳ khoản phí nào. Một mô hình chuyển tham chiếu thành video lấy các bức ảnh trong input_images:
-d '{"model": "pixverse/pixverse-c1-reference-to-video", "prompt": "the cat walks across the room",
"input_images": [{"url": "https://example.com/cat.png", "role": "reference"}],
"aspect_ratio": "16:9", "duration_seconds": 5}'
Các trường khác, nếu mô hình cung cấp: resolution (480p, 720p, 1080p…), aspect_ratio (16:9, 9:16, 1:1…) và audio (true / false; một mô hình không có cài đặt âm thanh sẽ không được gửi cài đặt này và tạo clip như bình thường).
Một mô hình chuyển ảnh thành video mà schema của nó không liệt kê aspect_ratios (hầu hết các mô hình chuyển ảnh thành video của Kling, Veo, Wan và Seedance) sẽ tạo clip theo hình dạng của ảnh nguồn của bạn. Gửi cho nó một bức ảnh đã có hình dạng bạn muốn (cắt thành 9:16 cho clip dọc) và bỏ qua aspect_ratio. Một hình dạng được gửi đến mô hình như vậy sẽ được trả lời 400 invalid_request trước khi có bất kỳ khoản phí nào ("aspect_ratio": "auto" được chấp nhận và có nghĩa tương tự như việc bỏ qua).
Một mô hình chuyển tham chiếu thành video cần một hình dạng, vì vậy khi bạn bỏ qua aspect_ratio, nó sẽ được gửi dưới dạng 16:9 (hoặc hình dạng đầu tiên của mô hình nếu nó không tạo 16:9); schema của mô hình hiển thị mặc định đó. Các lựa chọn của mỗi mô hình được liệt kê bởi GET /v1/models/<model id> (xem Các tùy chọn của mỗi mô hình).
Mỗi mô hình chỉ tạo ra các độ dài, độ phân giải và hình dạng clip nhất định. Một yêu cầu cho một loại mà nó không tạo ra sẽ bị từ chối với một thông báo liệt kê những loại nó có thể tạo, trước khi có bất kỳ khoản phí nào.
HTTP 202:
{
"id": "6f1c…",
"object": "media.job",
"kind": "video",
"status": "queued",
"model": "fal-ai/vidu/q3/text-to-video/turbo",
"estimated_cost_usd": 0.32725,
"estimated_cost_usdc": "327250",
"max_cost_usd": 0.359975,
"max_cost_usdc": "359975",
"poll_url": "/v1/video/generations/6f1c…",
"cancel_url": "/v1/video/generations/6f1c…"
}
model là mô hình đã nhận công việc (một bản dự phòng từ models khi mô hình đầu tiên không thể). Chi phí kết thúc bằng _usdc tính bằng phần triệu đô la (327250 = $0.33). estimated_cost_usd là giá dự kiến. Nó bắt đầu bằng giá niêm yết của những gì bạn yêu cầu (số validate và POST /v1/quote trả lời là cost_usd: giá hiện tại của mô hình nhân với số giây ở độ phân giải yêu cầu, hình ảnh hoặc các đơn vị khác). Khi người bán nhận công việc dự kiến tính phí nhiều hơn cho chính yêu cầu của bạn, estimated_cost_usd là con số của người bán đó thay thế: thường là từ phản hồi đầu tiên này trở đi, và muộn nhất là trên một GET sau đó của một công việc vẫn đang chạy (một số công việc có người bán của họ vài giây sau khi bắt đầu, và một công việc được chuyển sang người bán khác sẽ lấy giá của người bán đó). Nó chỉ tăng, không bao giờ vượt quá max_cost_usd. Công việc được tính phí theo những gì nhà cung cấp đã tính: thường là ước tính hoặc ít hơn, và trong những trường hợp hiếm hoi là nhiều hơn (một clip được tạo từ một bức ảnh mà người bán chỉ đặt giá khi nó kết thúc). max_cost_usd là số tiền được giữ từ số dư của bạn cho công việc: con số này không đổi trong khi nó chạy và sau khi nó kết thúc, và là số tiền tối đa công việc được tính phí. Không có công việc nào bị tính phí vượt quá số tiền này, ngay cả khi người bán đã bắt đầu nó bị mất và một người khác tiếp quản: một người bán có giá cao hơn max_cost_usd của bạn sẽ không được sử dụng. Một mô hình video có giá tính theo second được tính phí theo giây của clip; một mô hình có giá tính theo job có giá đó cho mỗi video.
2. Kiểm tra mỗi 5–10 giây:
curl -H "Authorization: Bearer $UBERLLM_API_KEY" \
https://api.martllm.com/v1/video/generations/<job id>
HTTP 202 khi công việc đang chạy, HTTP 200 khi nó kết thúc:
{
"id": "6f1c…",
"status": "succeeded",
"results": [{ "artifact_index": 0, "url": "https://api.martllm.com/v1/media/artifacts/6f1c…/0",
"content_type": "video/mp4", "duration_seconds": 5 }],
"usage": { "cost_usdc": "40000", "cost_usd": 0.04 }
}
Mô hình báo cáo phí chính xác của một công việc một chút sau khi tệp sẵn sàng, thường trong vòng 30 giây. Cho đến lúc đó, một công việc succeeded hiển thị "usage": { "cost_usd": null, "cost_pending": true }; hãy hỏi lại vài giây sau. Nếu phí chưa đến trong vòng 30 phút, công việc sẽ được tính theo giá niêm yết (estimated_cost_usd) và usage.cost_note sẽ thông báo như vậy.
3. Tải xuống
curl -L -o video.mp4 -H "Authorization: Bearer $UBERLLM_API_KEY" \
https://api.martllm.com/v1/media/artifacts/<job id>/0
Yêu cầu dừng một công việc bạn không còn cần: DELETE /v1/video/generations/<job id>. Chúng tôi yêu cầu nhà cung cấp dừng nó; một công việc đã được tạo sẽ được tính phí như bình thường, và một công việc bị dừng sẽ kết thúc canceled và không tốn phí.
Mô hình video Fal
Các mô hình có ID bắt đầu bằng fal-ai/ chạy trên Fal, với giá thấp hơn giá của Fal:
bạn trả giá của Fal trừ đi chiết khấu của người bán Fal rẻ nhất trên thị trường hiện tại (giảm 15% cho 30 tháng 10, 2026; giảm 25% bất cứ khi nào người bán đó đang bán). Giá được cố định dựa trên yêu cầu của bạn — số giây × tỷ lệ cho độ phân giải, và liệu clip có âm thanh hay không — vì vậy chi phí công việc được biết ngay khi bắt đầu và estimated_cost_usd chính xác là số tiền bạn phải trả. Một công việc thất bại không tốn phí. Việc dừng một công việc là nỗ lực tốt nhất: nếu Fal đã tạo clip, bạn sẽ bị tính phí.
curl https://api.martllm.com/v1/video/generations \
-H "Authorization: Bearer $UBERLLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "fal-ai/wan/v2.7/text-to-video", "prompt": "a woman twirls at a garden party at night",
"duration_seconds": 15, "resolution": "720p", "aspect_ratio": "9:16"}'
Giá của Fal mỗi giây (giá của bạn là giá này trừ đi chiết khấu trực tiếp; trang của mỗi mô hình, GET /v1/models và POST /v1/quote hiển thị giá chính xác hiện tại):
| Mô hình | Độ dài (s) | Giá của Fal mỗi giây, từ |
|---|---|---|
fal-ai/wan/v2.7/text-to-video, …/image-to-video |
2–15 | 720p $0.10 · 1080p $0.15 |
fal-ai/kling-video/v3/standard/text-to-video, …/image-to-video |
3–15 | $0.084 · có âm thanh $0.126 |
fal-ai/kling-video/v3/pro/text-to-video, …/image-to-video |
3–15 | $0.112 · có âm thanh $0.168 |
fal-ai/kling-video/o3/standard/text-to-video, …/image-to-video |
3–15 | $0.084 · có âm thanh $0.112 |
fal-ai/kling-video/v2.6/pro/text-to-video, …/image-to-video |
5, 10 | $0.07 · có âm thanh $0.14 |
fal-ai/veo3.1/fast, fal-ai/veo3.1/fast/image-to-video |
4, 6, 8 | 720p/1080p $0.10 · có âm thanh $0.15 · 4k $0.30 |
fal-ai/veo3.1, fal-ai/veo3.1/image-to-video |
4, 6, 8 | 720p/1080p $0.20 · có âm thanh $0.40 · 4k $0.40 |
fal-ai/veo3.1/lite |
4, 6, 8 | 720p $0.03 · có âm thanh $0.05 · 1080p $0.05 |
fal-ai/ltx-2.3/text-to-video/fast, …/image-to-video/fast |
6, 8, 10 | 1080p $0.06 · 1440p $0.12 · 2160p $0.24 |
fal-ai/ltx-2.3/text-to-video |
6, 8, 10 | 1080p $0.08 |
fal-ai/minimax/hailuo-02/standard/text-to-video, …/image-to-video |
6, 10 | 768P $0.045 · 512P (ảnh) $0.017 |
fal-ai/vidu/q3/text-to-video/turbo, …/image-to-video/turbo |
1–16 | 360p/540p $0.035 · 720p/1080p $0.077 |
fal-ai/vidu/q3/text-to-video, …/image-to-video |
1–16 | 360p/540p $0.07 · 720p/1080p $0.154 |
Mỗi mức giá là của riêng Fal; chiết khấu được áp dụng khi công việc bắt đầu. Nếu người bán rẻ nhất từ chối một công việc, một người bán đắt hơn sẽ thực hiện nó và công việc được tính phí theo giá của người bán đó, không bao giờ quá estimated_cost_usd trong phản hồi.
Một số mô hình tốn của chúng tôi ít hơn so với mức chiết khấu của người bán. Cứ sau 6 giờ chúng tôi so sánh những gì thị trường đã tính phí chúng tôi cho mỗi mô hình trong 7 ngày qua với giá của Fal cho cùng các công việc đó. Một mô hình có ít nhất 20 công việc trong thời gian đó sau đó được định giá theo tỷ lệ thực tế đó cộng thêm 5%, khi mức giá đó thấp hơn. Trang mô hình, /v1/models và hóa đơn đều sử dụng cùng một mức giá. Nếu con số đó đã quá 3 ngày, chiết khấu của người bán sẽ được áp dụng lại.
Các trường là của chúng tôi: duration_seconds, resolution, aspect_ratio, audio và image_url (hoặc input_images). Cách viết của Fal (duration, generate_audio, start_image_url) cũng hoạt động. Kling, Veo và Kling 2.6 thêm âm thanh trừ khi bạn gửi "audio": false.
Trạng thái job
status |
HTTP | Ý nghĩa |
|---|---|---|
queued |
202 | Đã tiếp nhận, đang chờ model bắt đầu xử lý |
running |
202 | Đang được tạo; progress chạy từ 0 đến 1 khi model báo cáo |
succeeded |
200 | Hoàn tất; tải xuống results[].url |
failed |
200 | Không tạo được. error.message cho biết lý do; error.retryable cho biết thử lại có hiệu quả hay không |
canceled |
200 | Đã dừng trước khi được tạo |
expired |
200 | Không hoàn thành kịp thời gian |
Chỉ có sáu giá trị này. failed, canceled và expired không mất phí. DELETE là yêu cầu dừng chứ không phải cam kết: nếu nhà cung cấp vẫn hoàn thành thì job sẽ kết thúc ở trạng thái succeeded và được tính phí.
Tự động thử lại khi hệ thống bận. Khi không có nhà cung cấp nào sẵn sàng tạo video cho bạn, hoặc nhà cung cấp hiện đang quá bận, MartLLM sẽ tự động chạy lại job thêm tối đa hai lần nữa trong vòng 10 phút. Hệ thống vẫn giữ nguyên job id và mức chi phí tối đa. Job chỉ mất thêm một chút thời gian. Bạn chỉ thấy failed khi tất cả các lần thử đều thất bại, và job thất bại thì không mất phí.
Chờ kết quả. Hãy gửi callback_url và chúng tôi sẽ báo cho bạn biết khi job kết thúc (xem Callbacks), hoặc truy vấn URL poll mỗi 5–10 giây. Phần lớn video mất từ 1–5 phút; một số job dài hoặc 4K sẽ mất nhiều thời gian hơn. Bạn không cần phải liên tục truy vấn để chi phí được quyết toán: ngay cả khi không có ai kiểm tra, job vẫn sẽ được MartLLM hoàn tất và tính phí (hoặc hoàn tiền), đồng thời hiển thị trong Bảng điều khiển → API Keys → Mức sử dụng API.
Các Callback
Thêm callback_url vào một tác vụ video hoặc nhạc: một liên kết https:// trên một máy chủ công cộng.
Khi tác vụ kết thúc hoàn toàn, MartLLM sẽ gửi một POST đến đó với cùng một JSON mà GET trên tác vụ trả về.
{ "model": "kling/kling-o3", "prompt": "a red ball bouncing", "duration_seconds": 5,
"callback_url": "https://your-app.example/uberllm/jobs" }
- Khi nào. Một lần, khi tác vụ đã kết thúc và hóa đơn của nó là cuối cùng:
succeededvớiusage.cost_usdđược đặt (không bao giờcost_pending), hoặcfailed,canceledhoặcexpired(chi phí 0). Nó không được gửi lại khi chi phí đến, vì nó chỉ được gửi sau đó. Vớioutput_upload_urlnữa, callback sẽ đến sau khi quá trình tải lên hoàn tất, vì vậyoutput_upload.statusđã làdeliveredhoặcfailed. - Headers.
Content-Type: application/json,MartLLM-Event: job.succeeded(hoặcjob.failed,job.canceled,job.expired),UberLLM-Event-Id: <job id>:<status>vàUberLLM-Signature: t=<unix seconds>,v1=<hex>. - Thử lại. Trả lời bằng bất kỳ 2xx nào trong vòng 15 giây. Bất kỳ câu trả lời nào khác, hoặc không có câu trả lời, sẽ được thử lại sau 30 giây, 2 phút, 10 phút, 30 phút và 2 giờ, sau đó sẽ bị bỏ qua. Bạn vẫn có thể thăm dò trạng thái tác vụ bất cứ lúc nào.
- Lặp lại. Một tin nhắn có thể đến nhiều hơn một lần (ví dụ khi câu trả lời của bạn bị mất). ID sự kiện vẫn giữ nguyên, vì vậy hãy bỏ qua những cái bạn đã xử lý.
- Trạng thái. Tác vụ hiển thị kết quả:
"callback": { "status": "delivered", "attempts": 1, "http_status": 200, "delivered_at": 1792540990 }.statuslàpending,deliveredhoặcfailed(vớierrorbằng lời thường). - Liên kết phải là
https://trên một máy chủ công cộng, không có tên người dùng hoặc mật khẩu trong đó. Nó không bao giờ được hiển thị lại và bị xóa ngay sau khi callback kết thúc.webhook_urlđược đọc là cùng một trường. Hình ảnh và giọng nói không sử dụng nó: chúng được trả về trong chính câu trả lời.
Kiểm tra chữ ký
Mọi tin nhắn đều được ký bằng webhook secret của tài khoản của bạn. Tìm nó trong Dashboard → API keys → Webhook signing secret; nó được tạo lần đầu tiên bạn mở nó, và Replace secret sẽ thay thế nó ngay lập tức.
v1 là hex HMAC-SHA256 của <t>.<raw body>, được khóa bằng toàn bộ secret (whsec_…). Tính toán nó trên các byte thô bạn nhận được (trước khi phân tích cú pháp JSON), so sánh trong thời gian không đổi, và từ chối một t đã quá 5 phút.
Node.js (Express):
import crypto from "node:crypto";
import express from "express";
const app = express();
const SECRET = process.env.UBERLLM_WEBHOOK_SECRET; // whsec_…
app.post("/uberllm/jobs", express.raw({ type: "application/json" }), (req, res) => {
const header = req.get("UberLLM-Signature") || "";
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=", 2)));
const expected = crypto.createHmac("sha256", SECRET)
.update(`${parts.t}.`).update(req.body).digest("hex");
const ok = parts.v1 && parts.v1.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(parts.v1), Buffer.from(expected)) &&
Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
if (!ok) return res.status(400).send("bad signature");
const job = JSON.parse(req.body);
// Drop a repeat: req.get("UberLLM-Event-Id") is the same each time.
console.log(job.id, job.status, job.usage?.cost_usd);
res.sendStatus(204);
});
Python (Flask):
import hashlib, hmac, os, time
from flask import Flask, request, abort
app = Flask(__name__)
SECRET = os.environ["UBERLLM_WEBHOOK_SECRET"].encode() # whsec_…
@app.post("/uberllm/jobs")
def uberllm_job():
raw = request.get_data() # the raw bytes, before any JSON parsing
parts = dict(p.split("=", 1) for p in request.headers.get("UberLLM-Signature", "").split(",") if "=" in p)
expected = hmac.new(SECRET, parts.get("t", "").encode() + b"." + raw, hashlib.sha256).hexdigest()
if not hmac.compare_digest(parts.get("v1", ""), expected) or abs(time.time() - int(parts.get("t", "0"))) > 300:
abort(400)
job = request.get_json()
# Drop a repeat: request.headers["UberLLM-Event-Id"] is the same each time.
print(job["id"], job["status"], job.get("usage", {}).get("cost_usd"))
return "", 204
Cảnh báo đến một webhook
Các email cảnh báo cũng có thể được gửi đến một webhook: đặt một liên kết dưới Dashboard → Credits → For developers: also send alerts to a webhook, hoặc PUT /api/v1/billing/alerts {"alerts_webhook_url": "https://…"} (null sẽ tắt nó). Các tin nhắn được ký, thử lại và nhận dạng theo cùng một cách như các callback. Nội dung là:
{ "id": "evt_…", "object": "event", "type": "balance.low", "created": 1792540990,
"data": { "balance_usd": 4.2, "threshold_usd": 5, "message": "Your balance is $4.20, below the $5.00 you set. Requests stop once it runs out.",
"add_credits_url": "https://martllm.com/dashboard/credits" } }
balance.low: số dư đã giảm xuống dưới mức bạn đặt cho email cảnh báo số dư thấp. Được gửi một lần mỗi khi nó giảm xuống dưới mức đó; không có gì được gửi cho đến khi bạn đặt một mức.hold.not_released: tiền dành cho một tác vụ vẫn bị giữ hơn 15 phút sau khi tác vụ kết thúc.data.jobsliệt kê chúng (id,kind,model,ended_at,held_usd) vàdata.held_usdlà tổng số. Số tiền vẫn là của bạn và đội ngũ của chúng tôi đã được thông báo.
Tệp được lưu trữ trong bao lâu
Hãy tải kết quả xuống ngay sau khi được tạo:
- Tệp video và nhạc được lưu trữ trong khoảng 3 giờ sau khi công việc kết thúc.
- Liên kết hình ảnh đến
/v1/media/artifacts/…được lưu trữ trong khoảng 15 phút; liên kết hình ảnh đến/v1/files/…trong 24 giờ. Yêu cầu"response_format": "b64_json"để nhận hình ảnh trong câu trả lời và tự lưu trữ. - Hình ảnh bạn tải lên
/v1/filesđược lưu trữ trong 24 giờ.
Sau thời gian đó, đường dẫn tải xuống sẽ trả về 404 artifact_expired.
Gửi kết quả đến bộ nhớ của riêng bạn
Thêm output_upload_url vào một công việc video hoặc nhạc: một liên kết https:// chấp nhận HTTP PUT, chẳng hạn như liên kết tải lên S3, R2 đã được ký trước hoặc Google Cloud Storage. Khi công việc thành công, MartLLM sẽ tải tệp lên đó với loại nội dung của nó. Đối với một công việc tạo ra nhiều tệp, hãy gửi output_upload_urls, mỗi tệp một liên kết theo thứ tự (tối đa 4).
{ "model": "kling/kling-o3", "prompt": "a red ball bouncing", "duration_seconds": 5,
"output_upload_url": "https://my-bucket.s3.amazonaws.com/ball.mp4?X-Amz-Signature=…" }
Trạng thái của công việc sau đó sẽ có output_upload:
"output_upload": { "status": "delivered", "attempts": 1, "delivered_at": 1792540990,
"files": [{ "artifact_index": 0, "http_status": 200, "bytes": 5242880 }] }
statuslàpendingcho đến khi quá trình tải lên hoàn tất, sau đó làdeliveredhoặcfailed(vớierrorbằng lời thường).- Một lần tải lên thất bại sẽ được thử lại sau 30 giây, 2, 10 và 30 phút, sau đó được đánh dấu
failed; tệp vẫn có thể được tải xuống từresults[].urltrong khi nó được lưu trữ. Hãy đảm bảo liên kết có hiệu lực ít nhất một giờ. - Liên kết phải là
https://trên một máy chủ công cộng, không có tên người dùng hoặc mật khẩu. Nó không bao giờ được hiển thị lại và sẽ bị xóa ngay sau khi quá trình tải lên kết thúc. - Hình ảnh không sử dụng nó: một hình ảnh sẽ được trả về trong chính câu trả lời.
Âm nhạc
Ba bước tương tự tại /v1/music/generations. curl -OJ lưu bản nhạc dưới tên tệp mà chúng ta gửi.
Giọng nói
Văn bản được đưa vào, và một tệp âm thanh sẽ được trả về làm câu trả lời.
curl https://api.martllm.com/v1/audio/speech \
-H "Authorization: Bearer $UBERLLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "x-ai/tts-xai-v1", "input": "Hello from MartLLM."}' \
-o speech.mp3
Bạn cũng có thể gửi voice, response_format (ví dụ mp3 hoặc wav) và speed.
Mỗi mô hình có các giọng nói riêng (GET /v1/models/{id} liệt kê chúng). Với
best-price:speech hoặc fastest:speech, bạn không biết trước mô hình nào được sử dụng,
vì vậy giọng nói sẽ được điều chỉnh cho phù hợp: giọng nói mà mô hình có sẽ được giữ lại, tên của OpenAI sẽ được ánh xạ tới
giọng nói phù hợp của mô hình nếu có (alloy → af_alloy), và bất kỳ giọng nói nào khác, hoặc
không có giọng nói nào, sẽ nhận giọng nói đầu tiên của mô hình. Khi bạn chỉ định một mô hình, giọng nói của bạn sẽ được gửi nguyên trạng.
Nó được tính phí theo mỗi 1K ký tự input đã bắt đầu. Câu trả lời là tệp âm thanh;
tiêu đề X-UberLLM-Cost-USD của nó cho biết chi phí là bao nhiêu, và X-Request-Id là ID của yêu cầu
như được liệt kê trong Hoạt động. "validate": true, max_cost, metadata, models và
provider.max_price hoạt động tương tự như trên hình ảnh (xem Bạn phải trả bao nhiêu).
Chuyển bản ghi âm thành văn bản
Gửi bản ghi âm dưới dạng biểu mẫu với file và model:
curl https://api.martllm.com/v1/audio/transcriptions \
-H "Authorization: Bearer $UBERLLM_API_KEY" \
-F model=venice/whisper-large-v3 \
-F [email protected]
{ "text": "Hello from MartLLM.", "duration": 4.2,
"usage": { "type": "duration", "seconds": 5, "cost_usd": 0.00055, "max_cost_usd": 0.00726 } }
usage.cost_usd là chi phí (cũng trong tiêu đề X-UberLLM-Cost-USD, nơi duy nhất cho các câu trả lời text, srt và vtt). Các trường riêng của chúng tôi cũng được đưa vào biểu mẫu và không bao giờ được gửi đến mô hình: -F max_cost=0.10, -F "metadata[project]=podcast", -F validate=true.
Bạn cũng có thể gửi language, prompt, temperature và response_format:
response_format |
Bạn nhận được |
|---|---|
json (mặc định) |
{ "text": …, "duration": …, "usage": … } |
text |
các từ dưới dạng văn bản thuần túy |
srt |
một tệp phụ đề có thời gian (SubRip), sẵn sàng cho trình chỉnh sửa video hoặc quảng cáo |
vtt |
các phụ đề tương tự như WebVTT |
verbose_json |
câu trả lời json cộng với segments (id, start, end, text, tính bằng giây) và, trên một mô hình tính thời gian từng từ, words |
curl https://api.martllm.com/v1/audio/transcriptions \
-H "Authorization: Bearer $UBERLLM_API_KEY" \
-F model=venice/whisper-large-v3 -F response_format=srt -F [email protected] -o captions.srt
1
00:00:00,330 --> 00:00:03,150
This serum is the one thing I use every morning.
2
00:00:03,300 --> 00:00:06,420
It took two weeks to see a change, now I never skip it.
venice/whisper-large-v3 cung cấp một phụ đề cho mỗi câu; elevenlabs/elevenlabs-scribe-v2 tính thời gian từng từ, và phụ đề của nó được cắt thành các dòng tối đa 42 ký tự, một dòng mới sau mỗi câu. Nếu một mô hình không gửi thông tin thời gian cho một bản ghi, srt, vtt và verbose_json trả lời 400 timestamps_unavailable và không có gì bị tính phí. Nó được tính phí theo phút âm thanh, bất kể định dạng nào. Các tệp có thể có dung lượng lên tới 40 MB. Định dạng (mp3, wav, ogg, flac, m4a/mp4, webm, aac) được đọc từ chính bản ghi, không phải tên tệp của nó, vì vậy một bản tải lên có tên tmp123.out vẫn hoạt động.
Với OpenAI SDK
from openai import OpenAI
client = OpenAI(base_url="https://api.martllm.com/v1", api_key="<your MartLLM key>")
speech = client.audio.speech.create(model="x-ai/tts-xai-v1", voice="eve", input="Hello from MartLLM.")
speech.write_to_file("speech.mp3")
with open("speech.mp3", "rb") as f:
text = client.audio.transcriptions.create(model="venice/whisper-large-v3", file=f)
print(text.text)
Bạn trả gì
- Giá của thứ đã được tạo ra: đúng mức nhà cung cấp đã tính, không có phí MartLLM. Một câu trả lời ảnh hoặc phiên âm và một tác vụ đã hoàn tất mang nó dưới dạng
usage.cost_usd(đô la Mỹ); mọi câu trả lời đã tạo ra thứ gì đó cũng mang nó trong header phản hồiX-UberLLM-Cost-USD(với giọng nói, header là nơi duy nhất, vì câu trả lời chính là tệp âm thanh). Nó hiển thị trong Bảng điều khiển → Hoạt động. Phần còn lại của khoản tạm giữ được trả lại. - Không mất gì cho một tác vụ
failed, đã bịcanceledhoặcexpired, hoặc cho một yêu cầu ảnh, giọng nói hoặc phiên âm bị lỗi. - Người bán rẻ nhất tạo đúng thứ bạn yêu cầu. Nhiều model ảnh và video có nhiều hơn một người bán; mỗi yêu cầu sẽ đến người bán rẻ nhất có thể tạo ra nó với thiết lập của bạn, và đến người khác nếu người đó không nhận được nó. Danh sách model và trang của từng model hiển thị giá tại người bán rẻ nhất hiện tại.
- Thiết lập định tuyến của key (Bảng điều khiển → API key) chọn giữa các người bán khi một người nhanh hơn: Giá thấp nhất luôn chọn người bán rẻ nhất, mặc định cũng chọn người bán rẻ nhất trừ khi nó cứ lỗi hoặc chậm hơn gấp đôi so với nhanh nhất, Cân bằng chọn người bán rẻ nhất chậm hơn nhanh nhất tối đa 20%, và Nhanh nhất chọn người bán nhanh nhất, tối đa bằng giá niêm yết của model. Một báo giá và
estimated_cost_usdcủa tác vụ hiển thị giá của người bán mà thiết lập của bạn chọn. Xem thiết lập định tuyến của key. - Xem số dư và khoản đang tạm giữ của bạn bằng
GET /v1/balance(bên dưới).
Kiểm tra giá trước khi chi tiền
Thêm "validate": true vào bất kỳ yêu cầu ảnh, video, nhạc hoặc giọng nói nào (với phiên âm, gửi validate=true dưới dạng trường form cùng bản ghi âm). Yêu cầu được kiểm tra như thể là thật (model, tùy chọn, ảnh nguồn), không có gì được tạo và không có gì bị tính phí, và HTTP 200 cho biết nó tốn bao nhiêu theo giá niêm yết (cost_usd, giá hiển thị trên trang của model; bạn trả đúng mức nhà cung cấp đã tính, có thể khác) và khoản nào bị tạm giữ trong khi nó chạy (max_cost_usd, mức tối đa có thể bị tính):
{ "object": "quote", "model": "bytedance/seedance-2-0-image-to-video", "kind": "video",
"valid": true, "cost_usd": 0.2117, "max_cost_usd": 0.4235, "unit": "second", "units": 5, "duration_seconds": 5,
"note": "Nothing was charged. …" }
Nếu người bán của model cần một thiết lập mà bạn bỏ sót (model reference-to-video cần aspect_ratio), giá trị mặc định mà nó được gửi kèm sẽ hiển thị trên schema của model và trong báo giá dưới dạng defaults_applied, ví dụ "defaults_applied": {"aspect_ratio": "16:9"}.
Một yêu cầu lẽ ra bị từ chối sẽ bị từ chối theo cùng cách, kèm lý do.
Giữ giá trong 15 phút
POST /v1/quote nhận cùng body như yêu cầu ảnh, video, nhạc hoặc giọng nói và trả về chi phí niêm yết (cost_usd), khoản bị tạm giữ trong khi nó chạy (max_cost_usd, mức tối đa có thể bị tính) và một quote_id (với phiên âm, gửi model và duration_seconds; bản thân phiên âm không nhận quote_id, dùng max_cost để giới hạn nó):
curl https://api.martllm.com/v1/quote \
-H "Authorization: Bearer $UBERLLM_API_KEY" -H "Content-Type: application/json" \
-d '{"model": "kling/kling-o3", "prompt": "a red ball bouncing", "duration_seconds": 5}'
{ "object": "quote", "id": "6f1c…", "quote_id": "6f1c…", "model": "kling/kling-o3",
"kind": "video", "cost_usd": 0.225, "max_cost_usd": 0.495, "unit": "job", "units": 1,
"expires_at": 1792541700, "note": "Nothing was charged. …" }
Gửi lại cùng yêu cầu với "quote_id": "6f1c…" trong vòng 15 phút và nó bị tính đúng mức nhà cung cấp đã tính, tối đa max_cost_usd; nếu khoản phải tạm giữ khi nó bắt đầu cao hơn max_cost_usd, nó bị hủy mà không tính phí. Bản thân báo giá không bị tính phí hay tạm giữ gì.
- Một báo giá bắt đầu một yêu cầu. Dùng lại báo giá đó sẽ trả về
409 quote_used; tác vụ chưa từng đến được model sẽ trả lại báo giá. - Yêu cầu phải hỏi đúng cùng một thứ: cùng model và cùng thiết lập (prompt, kích thước, độ dài clip, ảnh nguồn …). Bất kỳ thứ gì khác đều bị từ chối với
400 quote_mismatch.max_cost,metadatavàoutput_upload_urlcó thể khác nhau. - Sau 15 phút, nó trả về
400 quote_expired. Model chat bị tính theo token và không có báo giá: giới hạn chúng bằngprovider.max_price.
Model dự phòng và mức trần giá
"models": ["model-b", "model-c"] liệt kê các model để thử theo thứ tự khi model đầu tiên không thể được phục vụ ngay lúc này (no_available_provider) hoặc cao hơn provider.max_price của bạn. Bất kỳ từ chối nào khác đều được trả lời ngay lập tức. model của câu trả lời nêu tên model đã tạo ra nó (câu trả lời giọng nói chính là tệp âm thanh: Hoạt động hiển thị model của nó). Một yêu cầu có quote_id không nhận models, và phiên âm không nhận cả hai.
"provider": {"max_price": 0.05} là mức tối đa một đơn vị (định giá của model unit: ảnh, giây, megapixel, phút, 1K ký tự hoặc yêu cầu) có thể tốn, tính bằng đô la Mỹ. Model cao hơn mức đó bị từ chối với 400 max_price_exceeded, và yêu cầu không bao giờ bị tính cao hơn max_price lần số đơn vị của nó. Các tùy chọn provider khác bị từ chối với 400 unsupported_routing_option, vì lựa chọn người bán cho yêu cầu media không thể được điều khiển theo từng yêu cầu.
"model": "best-price:image" (hoặc image-edit, text-to-video, image-to-video, music, speech, transcription) chọn model đang hoạt động rẻ nhất cho tác vụ; fastest: chọn model nhanh nhất đã được đo. Xem bí danh model.
Thẻ
"metadata": {"project": "spring-ads"} (tối đa 16 giá trị văn bản) được lưu cùng tác vụ, được trả về trong trạng thái của nó, hiển thị trong Hoạt động và trong bản xuất CSV, và không bao giờ được gửi đến model. Với phiên âm, gửi chúng dưới dạng trường form: -F "metadata[project]=spring-ads". Xem Thẻ.
Đặt mức trần
Gửi "max_cost" (đô la Mỹ, ví dụ 0.50) cùng bất kỳ yêu cầu ảnh, video, nhạc hoặc giọng nói nào (một trường form với phiên âm). Nếu nó có thể tốn nhiều hơn mức đó, nó bị từ chối với 400 max_cost_too_low và không có gì bị tính phí. Với tác vụ video hoặc nhạc, mức trần chính xác được đặt khi tác vụ bắt đầu; nếu sau đó nó vượt quá max_cost của bạn, tác vụ bị hủy mà không tính phí. Với "validate": true, báo giá cộng thêm within_max_cost.
Thử lại mà không trả hai lần
Gửi một header Idempotency-Key (bất kỳ chuỗi duy nhất nào tối đa 255 ký tự, chẳng hạn UUID) khi bạn bắt đầu tác vụ video hoặc nhạc. Nếu kết nối của bạn bị ngắt và bạn gửi lại cùng yêu cầu với cùng key trong vòng 24 giờ, bạn nhận lại đúng tác vụ đó thay vì một tác vụ thứ hai. Cùng key với một yêu cầu khác bị từ chối với 409 idempotency_key_reused. Yêu cầu ảnh, giọng nói và phiên âm không nhận key: yêu cầu đã lỗi không bị tính phí, nên hãy gửi lại.
Số dư của bạn
curl -H "Authorization: Bearer $UBERLLM_API_KEY" https://api.martllm.com/v1/balance
{ "balance_usd": 12.40, "held_usd": 0.35, "available_usd": 12.05 }
held_usd được dành riêng cho các yêu cầu đang chạy; nó sẽ được hoàn lại (trừ đi chi phí thực tế) khi chúng kết thúc. available_usd là số tiền mà các yêu cầu mới có thể sử dụng.
Tùy chọn của từng model
GET /v1/models?type=image (hoặc video, music, speech, transcription,
audio cho cả hai cái đó, chat, all; nhiều cái nối với nhau bằng dấu phẩy; không có
type thì danh sách chỉ gồm các model chat) liệt kê các model bạn có thể gọi ngay bây giờ, mỗi model kèm type của nó, endpoints để gửi tới và pricing của nó. GET /v1/models/<model id> trả về một
model, và với model media thì trả về một object parameters: JSON Schema của request
body với độ dài clip, độ phân giải, tỷ lệ khung hình và kích thước mà nó nhận, và
nó cần ảnh nguồn nào.
curl -H "Authorization: Bearer $UBERLLM_API_KEY" \
https://api.martllm.com/v1/models/pixverse/pixverse-c1-reference-to-video
pricing có usd (mức cao nhất mà một unit hiện đang có giá) và list_usd (giá
riêng của hãng làm model); một model chat có input_usd, output_usd và giá
list_ của chúng trên mỗi 1M tokens.
usd là giá được báo ngay lúc này cho một request thường cho model: người bán
mà request của bạn sẽ đi tới khi key được đặt thành Balanced (mặc định), đã gồm
phí của chúng tôi. Các danh sách và báo giá được tính bởi cùng một đoạn code và cập nhật theo
người bán của chúng tôi trong khoảng 30 giây (một người bán bị tạm dừng, bị tắt hoặc đổi giá).
Một model được tính giá theo độ phân giải cũng có resolutions: mỗi độ phân giải một hàng
(480p / 720p / 1080p của video, 1K / 2K / 4K của ảnh), rẻ nhất trước, mỗi
hàng có usd (giá được báo cho một giây, hoặc một ảnh, ở độ phân giải đó) và
list_usd. usd ở trên là hàng rẻ nhất. Một clip được tính theo giá của
độ phân giải mà nó yêu cầu, nhân với số giây của nó:
"pricing": {"usd": 0.100884, "unit": "second", "resolutions": [
{"resolution": "480p", "usd": 0.100884, "list_usd": 0.1287},
{"resolution": "720p", "usd": 0.2268, "list_usd": 0.289},
{"resolution": "1080p", "usd": 0.56133, "list_usd": 0.7107}]}
Một số người bán tính giá cho cả clip, không phải theo giây. Một hàng như vậy cũng có seconds:
độ dài clip mà usd của nó là giá mỗi giây cho độ dài đó. Đó là mức giá đắt nhất
(clip ngắn nhất của model), nên một clip dài hơn có giá thấp hơn usd lần số
giây của nó, và một request không nêu độ dài được báo giá đúng bằng usd lần
seconds. seconds cũng xuất hiện khi một độ phân giải chỉ được bán ở một độ dài.
{"resolution": "720p", "usd": 0.062344, "list_usd": 0.075, "seconds": 4}
Giá mỗi giây được làm tròn đến $0.000001 gần nhất. Để biết giá chính xác của
một request, hãy yêu cầu báo giá ("validate": true).
Lỗi
| HTTP | mã | ý nghĩa |
|---|---|---|
| 400 | wrong_endpoint |
ví dụ: mô hình hình ảnh được gửi đến /v1/video/generations, mô hình trò chuyện được gửi đến tuyến hình ảnh, hoặc mô hình giọng nói được gửi đến /v1/audio/transcriptions; thông báo nêu rõ đường dẫn chính xác. Không có phí nào được tính, và Hoạt động liệt kê là bị từ chối |
| 400 | invalid_request |
yêu cầu sai (thông báo cho biết lý do, ví dụ: thời lượng mô hình không cung cấp hoặc thiếu ảnh nguồn) |
| 400 | image_required |
một chỉnh sửa, hoặc mô hình hình ảnh sang video hoặc tham chiếu sang video, không có ảnh nguồn |
| 400 | max_cost_too_low |
nó có thể tốn nhiều hơn max_cost của bạn; không có phí nào được tính |
| 400 | timestamps_unavailable |
srt, vtt hoặc verbose_json được yêu cầu từ một mô hình phiên âm mà không gửi thời gian; không có phí nào được tính |
| 409 | idempotency_key_reused |
Idempotency-Key đó đã được sử dụng cho một yêu cầu khác |
| 400 | quote_mismatch / quote_expired |
yêu cầu không phải là yêu cầu đã báo giá, hoặc báo giá đã quá 15 phút |
| 404 | quote_not_found |
không có báo giá nào như vậy trong tài khoản của bạn |
| 409 | quote_used |
báo giá đó đã bắt đầu một yêu cầu |
| 400 | max_price_exceeded |
mô hình này tốn nhiều hơn mỗi đơn vị so với provider.max_price của bạn |
| 400 | unsupported_routing_option |
một tùy chọn provider khác ngoài max_price |
| 404 | file_not_found |
không có tệp đã tải lên nào như vậy trong tài khoản của bạn, hoặc nó đã hết hạn |
| 413 | file_too_large |
một tệp tải lên vượt quá 10 MB |
| 429 | too_many_files |
500 tệp tải lên đã được lưu giữ; hãy xóa bớt hoặc đợi chúng hết hạn |
| 503 | files_unavailable |
tính năng tải lên hiện không khả dụng |
| 413 | request_too_large |
yêu cầu vượt quá giới hạn kích thước (40 MB); hãy gửi ảnh dưới dạng liên kết https:// và chia nhỏ các bản ghi dài |
| 402 | insufficient_credits |
số dư của bạn không đủ để chi trả chi phí tối đa của công việc; thông báo cho biết cần bao nhiêu |
| 404 | model_not_found / not_found |
không có mô hình nào như vậy, hoặc không có công việc nào như vậy trong tài khoản của bạn |
| 404 | artifact_expired |
tệp không còn được lưu giữ (xem ở trên) |
| 429 | rate_limited |
hãy đợi số giây trong Retry-After (vài giây nếu không có), sau đó thử lại; X-RateLimit-Remaining cho biết còn bao nhiêu yêu cầu trong phút này |
| 503 | no_available_provider |
không có nhà cung cấp nào có thể thực hiện ngay bây giờ; MartLLM đã thử các nhà cung cấp khác rồi. Thông báo nêu tên các mô hình cùng loại đang hoạt động |