Hình ảnh
Tạo hình ảnh
Tạo một hình ảnh từ lời nhắc (prompt)
Tổng quan
Sử dụng GET /v1/models?recommended_for=image để lấy các mô hình hình ảnh hiện tại, sau đó gửi model đã chọn một cách rõ ràng.
Mỗi mô hình chấp nhận các thao tác và trường riêng. GET /v1/models/{model} (Lấy thông tin mô hình) cung cấp endpoint cho từng thao tác trong tokenlab.request_format_summary.request_endpoint_by_operation, cùng các trường, giá trị và giới hạn được chấp nhận cho từng thao tác trong tokenlab.request_format_details.operation_constraints. Một trường mà mô hình không liệt kê có thể trả về lỗi 400 unsupported_parameter. Một thao tác gửi đến sai endpoint sẽ trả về 400 unsupported_endpoint.
Các tác vụ và kết quả hình ảnh:
- Các mô hình liệt kê
asynctrong số các tham số được hỗ trợ có thể tạo một tác vụ trước: gửiasync: true, sau đó pollGET /v1/tasks/{id}. - Các liên kết hình ảnh được lưu trữ trong 30 ngày; xem Lưu giữ dữ liệu.
- Gửi header
Idempotency-Keyđể thử lại yêu cầu tạo một cách an toàn sau khi hết thời gian chờ; xem Thử lại an toàn với idempotency key.
gpt-image-2 là một mô hình GPT Image được định giá theo token. TokenLab tuân theo bảng phân tích mức sử dụng chính thức của OpenAI cho token đầu vào văn bản, đầu vào hình ảnh, đầu vào lưu trong cache được báo cáo và đầu ra hình ảnh; nó không được tính phí theo mô hình cố định cho mỗi hình ảnh.
Đối với việc tạo hình ảnh bằng gpt-image-2, các tham số công khai được hỗ trợ là prompt, n, size, quality, response_format, async, background, output_format, output_compression hoặc compression, moderation và user. background chấp nhận auto hoặc opaque; transparent không được hỗ trợ. Bỏ qua size hoặc quality để TokenLab sử dụng auto; các giá trị size tùy chỉnh phải sử dụng quy tắc WIDTHxHEIGHT linh hoạt được ghi nhận bên dưới.
input_fidelity hiện không nằm trong các trường được TokenLab hỗ trợ cho gpt-image-2; hãy bỏ qua trường này, nếu không yêu cầu sẽ trả về 400 unsupported_parameter.
Xuất SVG và GIF
gpt-image-2.6-flare và gpt-image-2.6-sunburst có thể trả về định dạng SVG hoặc GIF động thay vì ảnh raster. Các model khác sẽ từ chối các định dạng này.
- SVG: gửi
output_format: "svg"vàsvg: {"model": "..."}. Model hình ảnh trước tiên sẽ vẽ một hình ảnh tham chiếu, sau đó model tác giả sẽ viết SVG từ hình ảnh đó.svg.modellà bắt buộc; danh sách chi tiết model sẽ hiển thị các giá trị được chấp nhận trongparameter_options(svg.model). Bạn cũng có thể gửisvg.reasoning.effort. SVG chỉ hoạt động trên endpoint này, vớin: 1, và không cópartial_imageshoặcoutput_compression. - GIF: gửi
output_format: "gif".frame_count(từ 2 đến 16, mặc định là 9) thiết lập số lượng khung hình, vàframe_duration_ms(từ 20 đến 2000, mặc định là 200) thiết lập thời gian của mỗi khung hình.sizelà kích thước của một khung hình. GIF không chấp nhậnpartial_imageshoặcoutput_compression.
Kết quả nằm trong data[].b64_json hoặc data[].url, tương tự như các hình ảnh khác. Giải mã SVG dưới dạng văn bản XML UTF-8 và lưu dưới đuôi .svg; lưu GIF dưới đuôi .gif.
Thanh toán: token hình ảnh được tính phí theo giá token của model, và các khung hình GIF được tính là token đầu ra hình ảnh. Một yêu cầu SVG cũng tính phí token của model tác giả, được báo cáo trong phản hồi tại svg_usage, theo giá tạo SVG hiển thị trên trang model.
Lưu ý về hành vi của mô hình
Các mô hình thuộc họ hình ảnh Google Gemini không dùng chung một quy tắc bộ chọn:
gemini-3.1-flash-image,gemini-nano-banana-2.1,gemini-3-pro-image,nano-banana-2.1vànano-banana-prohỗ trợaspect_ratiocùng vớiresolution(1k,2k,4k) cho các thao tác công khai text-to-image, image-to-image và image-edit.nano-banana-2hỗ trợaspect_ratiovàresolution(1k,2k,4k) cho cả việc tạo text-to-image và image-to-image.gemini-3.1-flash-lite-imagevànano-banana-2-litechỉ hỗ trợ text-to-image, image-to-image và image-edit ở độ phân giải1k.nano-bananahỗ trợaspect_rationhưng không cung cấp lựa chọnresolutioncông khai.- Đối với image-to-image với
gemini-3.1-flash-image,gemini-nano-banana-2.1,gemini-3.1-flash-lite-imagehoặcgemini-3-pro-image, hãy sử dụng endpoint này vớioperation: "image-to-image"và các hình ảnh tham chiếu. Gửi các yêu cầu image-edit cho các mô hình này tới/v1/images/edits. - Đối với các yêu cầu hình ảnh tham chiếu của Nano Banana, sử dụng
nano-banana-2,nano-banana-2.1,nano-banana-2-litehoặcnano-banana-protrên endpoint này (/v1/images/generations) vớioperation: "image-to-image"vàimage_urls. Các yêu cầu image-edit chonano-banana-2,nano-banana-2.1,nano-banana-2-litevànano-banana-procũng sử dụng endpoint này, vớioperation: "image-edit". Không gửi các yêu cầu hình ảnh tham chiếu Nano Banana tới/v1/images/edits. - Hình ảnh tham chiếu trên endpoint này có thể được cung cấp dưới dạng JSON
image_url/image_urls, hoặc dưới dạng tệpimagemultipart.images[]vàfile_idkhông được chấp nhận trên/v1/images/generations; chỉ tạo tham chiếu/v1/filescho các mô hình/v1/images/editscó tài liệu hướng dẫn vềimages[].file_id.
Đối với các họ hình ảnh của Google, hãy ưu tiên sử dụng aspect_ratio và chỉ gửi resolution khi mô hình hỗ trợ rõ ràng.
Các mô hình hình ảnh xAI Grok Imagine (grok-imagine-image và grok-imagine-image-2.0) hỗ trợ aspect_ratio cùng với resolution (1k, 2k). Text-to-image sử dụng endpoint này. Các yêu cầu image-to-image và image-edit của chúng sử dụng /v1/images/edits.
hy-image-v3.5-preview tạo một hình ảnh 1024x1024 cho mỗi yêu cầu từ văn bản trên endpoint này và chỉ hỗ trợ response_format: "url". Mô hình này chỉnh sửa hình ảnh tham chiếu trên /v1/images/edits.
Thân yêu cầu
Thời gian chờ cho yêu cầu đồng bộ: Một số yêu cầu hình ảnh trả về hình ảnh cuối cùng inline và chờ quá trình tạo hoàn tất. Các yêu cầu độ phân giải cao hoặc chất lượng cao có thể mất gần một phút hoặc lâu hơn, vì vậy hãy đặt thời gian chờ HTTP client của bạn ít nhất là 120s. Nếu phản hồi tạo chứa status: "pending", task_id hoặc poll_url, hãy poll GET /v1/tasks/{task_id} để thay thế.
Mô hình cần sử dụng (ví dụ: gpt-image-2, flux-pro-1.1 hoặc nano-banana-pro). Truy vấn GET /v1/models?recommended_for=image để lấy danh sách đề xuất hiện tại.
Mô tả văn bản của hình ảnh mong muốn, tối đa 32.000 ký tự. Bắt buộc đối với mọi mô hình có chi tiết liệt kê prompt.
text-to-image, image-to-image hoặc image-edit. Khi bỏ qua, mặc định sẽ là image-to-image nếu yêu cầu có hình ảnh tham chiếu, ngược lại là text-to-image. Đặt image-edit cho các mô hình có thao tác chỉnh sửa nằm trên endpoint này, chẳng hạn như nano-banana-pro. text-to-image với hình ảnh tham chiếu sẽ trả về 400 invalid_parameter.
URL hình ảnh công khai cho quá trình tạo image-to-image. Đối với các yêu cầu hình ảnh tham chiếu Nano Banana, hãy đặt operation thành image-to-image; nano-banana-pro có thể bao gồm resolution.
URL hình ảnh tham chiếu công khai, tối đa 16. Sử dụng trường này cho một hoặc nhiều hình ảnh tham chiếu trong các yêu cầu JSON. file_id và images[] không được hỗ trợ trên endpoint này.
Các URL hình ảnh tham chiếu bổ sung, tối đa 16, dành cho các mô hình phân biệt đầu vào chính với các tham chiếu.
Tệp hình ảnh tham chiếu multipart cho quá trình tạo image-to-image. Sử dụng tùy chọn này khi hình ảnh nguồn ở chế độ riêng tư hoặc được bảo vệ bằng header. Tùy chọn này khác với file_id của /v1/files, vốn không được chấp nhận trên endpoint này.
1Số lượng hình ảnh cần tạo (1-10, tùy thuộc vào mô hình).
Kích thước hình ảnh. Sử dụng trường này cho các họ hình ảnh theo phong cách OpenAI và các mô hình khác chấp nhận kích thước pixel chính xác.
Đối với gpt-image-2, size chấp nhận auto hoặc WIDTHxHEIGHT. Cả hai kích thước tùy chỉnh đều phải là bội số của 16, cạnh dài nhất tối đa là 3840px, tỷ lệ dài/ngắn tối đa là 3:1 và tổng số pixel phải nằm trong khoảng từ 655,360 đến 8,294,400. aspect_ratio và resolution hiện không thuộc chi tiết mô hình TokenLab cho gpt-image-2.
Đối với các mô hình hình ảnh của Google có các bậc độ phân giải (gemini-3.1-flash-image, gemini-nano-banana-2.1, gemini-3-pro-image, gemini-3.1-flash-lite-image, nano-banana-2, nano-banana-2.1 và nano-banana-pro), size chấp nhận kích thước đầu ra từ bảng kích thước của mô hình, chẳng hạn như 1376x768 (16:9 ở 1K), hoặc một bậc độ phân giải: 1K, 2K hoặc 4K. TokenLab gửi một bậc dưới dạng resolution, do đó yêu cầu và giá của nó tương tự như khi dùng resolution. Một bậc mà mô hình không hỗ trợ (ví dụ: 2K trên gemini-3.1-flash-lite-image), hoặc một bậc khác với resolution, sẽ trả về lỗi 400 với mã invalid_image_size_contract cùng các allowed_resolutions của mô hình. Đối với các mô hình này, định dạng được khuyến nghị là aspect_ratio cùng với resolution.
Bộ chọn tỷ lệ khung hình tùy thuộc vào mô hình.
Các giá trị phổ biến của họ hình ảnh Google bao gồm 1:1, 16:9, 9:16, 3:2 và 2:3.
Độ phân giải đầu ra tùy thuộc vào mô hình. gemini-3.1-flash-image, gemini-nano-banana-2.1, gemini-3-pro-image, nano-banana-2, nano-banana-2.1 và nano-banana-pro hỗ trợ 1k, 2k và 4k; các mô hình hình ảnh Grok Imagine hỗ trợ 1k và 2k. Bỏ qua trường này trừ khi mô hình và thao tác đã chọn hỗ trợ rõ ràng.
Chất lượng hình ảnh. Các mô hình GPT Image như gpt-image-2 sử dụng auto, low, medium hoặc high. Các mô hình khác có thể sử dụng các giá trị khác nhau; hãy kiểm tra chi tiết mô hình trước khi gửi một giá trị không mặc định.
Định dạng tệp của hình ảnh: png, jpeg, hoặc webp. gpt-image-2.6-flare và gpt-image-2.6-sunburst cũng chấp nhận svg và gif; xem Đầu ra SVG và GIF.
Các cài đặt SVG, chỉ dùng với output_format: "svg". model (bắt buộc) chọn model tác giả để viết SVG. reasoning.effort tùy chọn thiết lập mức độ nỗ lực suy luận.
9Số lượng khung hình GIF, từ 2 đến 16. Chỉ dùng với output_format: "gif".
200Thời gian của mỗi khung hình GIF tính bằng mili giây, từ 20 đến 2000. Chỉ dùng với output_format: "gif".
Cách thức trả về hình ảnh: url hoặc b64_json.
- Bỏ qua: khi mô hình trả về byte hình ảnh, mỗi hình ảnh sẽ nằm trong
data[].b64_json, và cũng nằm trongdata[].urlkhi TokenLab đã lưu trữ hình ảnh đó. Khi mô hình trả về một liên kết, mỗi hình ảnh sẽ nằm trongdata[].url. url: mỗi hình ảnh chỉ nằm trongdata[].url.b64_json: mỗi hình ảnh chỉ nằm trongdata[].b64_jsondưới dạng dữ liệu Base64.
Các liên kết là các URL kết quả media của TokenLab. Chúng duy trì hiệu lực trong 30 ngày. Xem Lưu giữ dữ liệu.
falseĐặt thành true để tạo tác vụ trước. Chỉ những model liệt kê async trong các tham số được hỗ trợ mới chấp nhận giá trị này, ví dụ như gpt-image-2, flux-pro-1.1, nano-banana-pro và seedream-5.0-lite; đối với bất kỳ model nào khác, yêu cầu sẽ trả về 400 unsupported_async_mode. Các tác vụ hình ảnh async đã hoàn tất sẽ trả về URL bất kể response_format được yêu cầu là gì; hãy sử dụng các yêu cầu đồng bộ (synchronous) khi bạn cần b64_json.
Bộ chọn phong cách tùy chọn. Chỉ gửi trường này khi mô hình đã chọn ghi rõ trong tài liệu; bỏ qua trường này đối với gpt-image-2 trừ khi metadata của mô hình có quy định khác.
Mã định danh duy nhất cho người dùng cuối.
Một số mô hình cũng chấp nhận các trường như negative_prompt, seed, width, height, steps, guidance_scale hoặc mask_url. Chỉ gửi chúng khi chi tiết của mô hình có liệt kê. stream: true không được hỗ trợ và sẽ trả về 400 unsupported_parameter.
Phản hồi
Phản hồi Inline
Unix timestamp thời điểm tạo.
Mảng chứa các hình ảnh đã tạo.
Mỗi đối tượng bao gồm:
url(string): URL kết quả media TokenLab của hình ảnh, có hiệu lực trong 30 ngày. Không xuất hiện khiresponse_formatlàb64_json. Khiresponse_formatbị bỏ qua, trường này sẽ không có nếu TokenLab không thể lưu trữ hình ảnh.b64_json(string): Dữ liệu hình ảnh Base64. Xuất hiện khiresponse_formatlàb64_json, hoặc khi bị bỏ qua và mô hình trả về byte hình ảnh.revised_prompt(string): Lời nhắc đã sửa đổi tùy chọn, khi mô hình đã chọn trả về
Số lượng token (input_tokens, output_tokens, total_tokens và chi tiết của chúng) cho các mô hình định giá theo token như gpt-image-2, khi khả dụng.
Số lượng token của mô hình tạo SVG (model, input_tokens, output_tokens, reasoning_tokens, total_tokens). Chỉ xuất hiện đối với đầu ra SVG. Các token này không nằm trong usage và được tính phí theo giá tạo SVG.
Phản hồi tác vụ Async
Đặt async: true trên một mô hình hỗ trợ nó để tạo một tác vụ thay vì chờ hình ảnh cuối cùng trong yêu cầu tạo. Phản hồi sẽ bao gồm status: "pending", task_id và poll_url. Poll /v1/tasks/{task_id} cho đến khi tác vụ đạt completed hoặc failed.
Các tác vụ hình ảnh async chỉ trả về URL hình ảnh cuối cùng. Nếu bạn cần dữ liệu hình ảnh b64_json thô, hãy sử dụng yêu cầu đồng bộ.
Hệ thống thanh toán có thể giữ tạm tính số tiền ước tính khi tác vụ được tạo. Các tác vụ đã hoàn thành sẽ được tính phí theo mức sử dụng thực tế, còn các tác vụ thất bại hoặc hết thời gian chờ sẽ được giải phóng hoặc hoàn tiền.
Unix timestamp thời điểm tạo.
Mã định danh tác vụ duy nhất để thực hiện polling.
Trạng thái ban đầu: pending.
URL tương đối để poll kết quả, ví dụ: /v1/tasks/{id}.
Trống khi tác vụ đang ở trạng thái pending. Các tác vụ hình ảnh đã hoàn thành sẽ trả về các URL hình ảnh đã tạo trong data[].url.
Khi bạn nhận được status: "pending", hãy gọi GET /v1/tasks/{task_id} để lấy kết quả.
Yêu cầu
curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-pro-image",
"prompt": "A cinematic portrait of a white cat sitting on a rainy windowsill",
"aspect_ratio": "16:9",
"resolution": "2k"
}'from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://api.tokenlab.sh/v1"
)
response = client.images.generate(
model="gemini-3-pro-image",
prompt="A cinematic portrait of a white cat sitting on a rainy windowsill",
extra_body={"aspect_ratio": "16:9", "resolution": "2k"}
)
print(response.data[0].url)import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'sk-your-api-key',
baseURL: 'https://api.tokenlab.sh/v1'
});
const response = await client.images.generate({
model: 'gemini-3-pro-image',
prompt: 'A cinematic portrait of a white cat sitting on a rainy windowsill',
aspect_ratio: '16:9',
resolution: '2k'
});
console.log(response.data[0].url);<?php
$ch = curl_init('https://api.tokenlab.sh/v1/images/generations');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer sk-your-api-key'
],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'gemini-3-pro-image',
'prompt' => 'A cinematic portrait of a white cat sitting on a rainy windowsill',
'aspect_ratio' => '16:9',
'resolution' => '2k'
])
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
echo $data['data'][0]['url'];Ví dụ họ hình ảnh chỉ dùng tỷ lệ: đối với nano-banana, hãy gửi aspect_ratio nhưng bỏ qua resolution:
{
"model": "nano-banana",
"prompt": "A clean editorial product shot of a citrus soda can",
"aspect_ratio": "16:9"
}Ví dụ hình ảnh tham chiếu cho Nano Banana Pro: gửi yêu cầu tới /v1/images/generations, không phải /v1/images/edits. resolution là tùy chọn và có thể được đặt thành 1k, 2k hoặc 4k:
{
"model": "nano-banana-pro",
"prompt": "Create a clean cinematic character image based on the reference images",
"operation": "image-to-image",
"image_urls": ["https://example.com/reference-1.png"],
"aspect_ratio": "1:1",
"resolution": "2k"
}Ví dụ tải lên multipart trực tiếp cho hình ảnh nguồn cục bộ hoặc riêng tư. Không truyền file_id vào /v1/images/generations:
curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-F "model=nano-banana-pro" \
-F "prompt=Create a clean cinematic character image based on this reference" \
-F "operation=image-to-image" \
-F "image=@reference.png" \
-F "aspect_ratio=1:1" \
-F "resolution=2k"Phản hồi
{
"created": 1706000000,
"data": [
{
"url": "https://...",
"revised_prompt": "A fluffy white cat with bright eyes sitting peacefully on a wooden windowsill, watching raindrops stream down the glass window..."
}
]
}Lỗi
Các lỗi yêu cầu sẽ trả về 400 (413 đối với các tệp tải lên quá kích thước) kèm theo error.code. Các mã phổ biến cho các yêu cầu hình ảnh:
| Code | Nguyên nhân |
|---|---|
unsupported_parameter | Mô hình không liệt kê trường này, hoặc stream là true |
unsupported_operation | Mô hình không có operation này |
unsupported_endpoint | Thao tác cho mô hình này nằm trên endpoint khác, chẳng hạn như /v1/images/edits |
unsupported_async_mode | Mô hình không hỗ trợ async: true |
invalid_resolution, invalid_aspect_ratio, invalid_parameter_value, too_many_items | Một giá trị nằm ngoài phạm vi mà mô hình chấp nhận. Lỗi sẽ nêu rõ các giá trị được chấp nhận |
invalid_image_size_contract | Một size hoặc bậc độ phân giải mà mô hình không hỗ trợ, hoặc xung đột với resolution |
prompt_too_long | Lời nhắc dài hơn mức mô hình chấp nhận |
request_too_large, file_too_large | Dung lượng tải lên vượt quá giới hạn kích thước (50 MiB cho mỗi tệp, 200 MiB cho tất cả các đầu vào) |
Để biết các quy tắc về số dư (402), giới hạn tần suất (429) và thử lại, xem Xử lý lỗi.
Chọn một mô hình
Truy vấn GET /v1/models?recommended_for=image hoặc sử dụng Trang mô hình để biết tính khả dụng, năng lực và giá cả hiện tại.
Không nên hard-code một mô hình là luôn luôn đồng bộ hoặc luôn luôn bất đồng bộ. Một yêu cầu không có async: true vẫn có thể trả về status: "pending"; bất cứ khi nào phản hồi tạo mang status: "pending" hoặc status: "processing", hãy poll GET /v1/tasks/{task_id} cho đến khi hoàn thành.
Xử lý phản hồi dạng tác vụ
Đối với các mô hình hình ảnh, luôn kiểm tra xem phản hồi có chứa status: "pending" / status: "processing" hay không:
import requests
import time
def generate_image(prompt, model="gpt-image-2"):
# Create image request
response = requests.post(
"https://api.tokenlab.sh/v1/images/generations",
headers={"Authorization": "Bearer sk-your-api-key"},
json={"model": model, "prompt": prompt, "async": True},
timeout=120
)
response.raise_for_status()
data = response.json()
# Check if task-based
if data.get("status") in ("pending", "processing"):
task_id = data["task_id"]
print(f"Image task started: {task_id}")
# Poll for result
deadline = time.time() + 600
while time.time() < deadline:
status_resp = requests.get(
f"https://api.tokenlab.sh/v1/tasks/{task_id}",
headers={"Authorization": "Bearer sk-your-api-key"},
timeout=30
)
status_resp.raise_for_status()
status_data = status_resp.json()
if status_data["status"] == "completed":
return status_data["data"][0]["url"]
elif status_data["status"] == "failed":
raise Exception(status_data.get("error", "Generation failed"))
time.sleep(3)
raise TimeoutError(f"Image task {task_id} did not finish in time")
else:
# Inline response
return data["data"][0]["url"]
# Usage
url = generate_image("a beautiful sunset over mountains", model="gpt-image-2")
print(f"Generated image: {url}")Ví dụ về Hy Image 3.5 Preview. Mô hình này chỉ chấp nhận size là 1024x1024 và n là 1:
{
"model": "hy-image-v3.5-preview",
"prompt": "A yellow lemon on a white table",
"size": "1024x1024",
"n": 1,
"response_format": "url"
}Xác thực
BearerAuth 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
Header
Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.
Giá trị hợp lệ
- "auto"
- "verified"
- "official"
Khóa tùy chọn giúp yêu cầu hình ảnh trở nên an toàn khi thử lại nếu yêu cầu đó đã tạo một tác vụ. Hãy gửi một giá trị duy nhất mới, chẳng hạn như UUID, cho mỗi yêu cầu. Thử lại với cùng khóa và cùng phần thân sẽ trả về tác vụ đó và không tạo, điều phối hoặc tính phí tác vụ thứ hai. Đối với yêu cầu trả về hình ảnh trực tiếp, thử lại với cùng khóa có thể trả về trạng thái tác vụ thay vì hình ảnh, hoặc 409 kèm idempotent_response_not_replayable. Phần thân khác với khóa đã được chấp nhận sẽ bị từ chối; mã trạng thái và mã lỗi cho trường hợp này không được đảm bảo. Khóa dài hơn 255 ký tự sẽ bị bỏ qua và yêu cầu đó sẽ không có bảo vệ idempotency. Xem Thử lại an toàn với khóa idempotency.
1 <= length <= 255Phản hồi
application/json
application/json
application/json
application/json
application/json
application/json
application/json