Kiểm soát định tuyến theo từng yêu cầu
Đặt trần so với giá chính thức, số lần thử lại và thời hạn tạo văn bản qua các tiêu đề HTTP tùy chọn.
Kiểm soát định tuyến theo từng yêu cầu
Chọn hoặc loại trừ kênh
Đặt phạm vi kênh cho yêu cầu tạo văn bản, hình ảnh hoặc video. Có thể dùng cả hai tiêu đề. Quy tắc loại trừ được ưu tiên.
X-APIMaster-Include-Channels· Chỉ cho phép các kênh đã liệt kê.X-APIMaster-Exclude-Channels· Loại trừ các kênh đã liệt kê.
Mỗi tiêu đề chấp nhận tối đa 64 số nguyên dương phân tách bằng dấu phẩy. Tra cứu channel_id công khai của mô hình. Khóa API và tùy chọn trong bảng điều khiển quyết định các kênh có thể dùng. Kênh cũng cần hỗ trợ thao tác và các tham số trong yêu cầu.
curl "https://apimaster.ai/api/public/marketplace?model=deepseek-flash"
Các lần thử lại và tuyến dự phòng tuân theo phạm vi này. Tạo bất đồng bộ lưu phạm vi, và các điểm cuối hỗ trợ gửi theo khóa idempotency đưa nó vào bước kiểm tra.
Tiêu đề không hợp lệ trả về 400 invalid_routing_parameter. Nếu không có kênh phù hợp, API trả về 503 no_provider_within_channel_scope. Truy vấn và tải xuống sử dụng kênh của tác vụ hiện có.
Bỏ các tiêu đề này khi truy vấn hoặc tải kết quả. Điểm cuối không được hỗ trợ và nhóm FreeModel được quản lý trả về 400 routing_controls_unsupported.
Ví dụ tạo nội dung
curl "https://apimaster.ai/v1/chat/completions" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Exclude-Channels: $TEXT_CHANNEL_ID" \
-d '{"model":"deepseek-flash","messages":[{"role":"user","content":"Reply with OK."}]}'
curl "https://apimaster.ai/v1/images/generations/async" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Include-Channels: $IMAGE_CHANNEL_ID" \
-d '{"model":"gpt-image-2","prompt":"A blue ceramic cup on a white table","size":"1024x1024"}'
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Include-Channels: $VIDEO_CHANNEL_ID" \
-d '{"model":"wan3.0-video-prime","prompt":"A flower sways in a light breeze","duration":2,"resolution":"480P"}'
Giá, số lần thử lại và thời hạn cho văn bản
Đặt trần so với giá chính thức, số lần thử lại và thời hạn tạo văn bản qua các tiêu đề HTTP tùy chọn.
| Tiêu đề | Hành vi |
|---|---|
X-APIMaster-Max-Official-Price-Ratio |
Tỷ lệ tối đa so với giá chính thức, dưới dạng số dương. 0.5 cho phép tối đa một nửa giá chính thức, còn 1 cho phép đến mức giá chính thức. |
X-APIMaster-Max-Retries |
Số lần thử bổ sung tối đa sau lần đầu, dưới dạng số nguyên không âm. 0 chỉ cho phép gửi một lần. Việc đổi nhà cung cấp hoặc chuyển sang nhà cung cấp chính thức đều được tính. |
X-APIMaster-Timeout-Ms |
Thời hạn tổng thể tính bằng mili giây, dưới dạng số nguyên dương kể từ khi cổng API nhận yêu cầu. Thời hạn bao gồm định tuyến, thử lại và truyền phát. Áp dụng giới hạn ngắn hơn. |
Có thể dùng từng tiêu đề riêng. Mục được bỏ qua áp dụng chính sách hiện có và tùy chọn nhà cung cấp trong bảng điều khiển vẫn có hiệu lực. Trần giá áp dụng cho đơn giá đầu vào, đầu ra và bộ nhớ đệm liên quan. Tổng phí phụ thuộc vào lượng sử dụng. Khi nội dung đã bắt đầu truyền, cổng API không tạo lại ở nhà cung cấp khác.
Điểm cuối được hỗ trợ
POST /v1/chat/completionsPOST /v1/responsesPOST /v1/messagesPOST /v1beta/models/{model}:generateContentPOST /v1beta/models/{model}:streamGenerateContent
Các thiết lập này áp dụng cho tạo văn bản. Điểm cuối hình ảnh, video và các điểm cuối không hỗ trợ trả về 400 routing_controls_unsupported nếu nhận các tiêu đề này. Các mục tính phí riêng, chẳng hạn lệnh gọi công cụ, nằm ngoài trần giá văn bản.
Ví dụ
curl https://apimaster.ai/v1/chat/completions \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-APIMaster-Max-Official-Price-Ratio: 0.5" \
-H "X-APIMaster-Max-Retries: 1" \
-H "X-APIMaster-Timeout-Ms: 30000" \
-d '{"model":"gpt-6.2-sol","messages":[{"role":"user","content":"Reply with OK."}]}'
Lỗi
Giá trị không hợp lệ trả về 400 invalid_routing_parameter. Khi không xác minh được giá chính thức, API trả về 400 official_price_unavailable. Nếu không có nhà cung cấp phù hợp với trần giá, API trả về 503 no_provider_within_price_limit trước khi gửi. Khi hết hạn, API trả về 504 request_deadline_exceeded nếu phản hồi chưa bắt đầu hoặc kết thúc luồng đang chạy.
