TokenLab

Hình ảnh

Tạo hình ảnh

Tạo một hình ảnh từ lời nhắc (prompt)

POST
/v1/images/generations

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ê async trong số các tham số được hỗ trợ có thể tạo một tác vụ trước: gửi async: true, sau đó poll GET /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.model là bắt buộc; danh sách chi tiết model sẽ hiển thị các giá trị được chấp nhận trong parameter_options (svg.model). Bạn cũng có thể gửi svg.reasoning.effort. SVG chỉ hoạt động trên endpoint này, với n: 1, và không có partial_images hoặc output_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. size là kích thước của một khung hình. GIF không chấp nhận partial_images hoặc output_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.1 và nano-banana-pro hỗ trợ aspect_ratio cùng với resolution (1k, 2k, 4k) cho các thao tác công khai text-to-image, image-to-image và image-edit.
  • nano-banana-2 hỗ trợ aspect_ratio và resolution (1k, 2k, 4k) cho cả việc tạo text-to-image và image-to-image.
  • gemini-3.1-flash-lite-image và nano-banana-2-lite chỉ hỗ trợ text-to-image, image-to-image và image-edit ở độ phân giải 1k.
  • nano-banana hỗ trợ aspect_ratio nhưng không cung cấp lựa chọn resolution cô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-image hoặc gemini-3-pro-image, hãy sử dụng endpoint này với operation: "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-lite hoặc nano-banana-pro trên endpoint này (/v1/images/generations) với operation: "image-to-image" và image_urls. Các yêu cầu image-edit cho nano-banana-2, nano-banana-2.1, nano-banana-2-lite và nano-banana-pro cũng sử dụng endpoint này, với operation: "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ệp image multipart. images[] và file_id không được chấp nhận trên /v1/images/generations; chỉ tạo tham chiếu /v1/files cho các mô hình /v1/images/edits có 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ế.

modelstringbắt buộc

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.

promptstringbắt buộc

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.

operationstring

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.

image_urlstring

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.

image_urlsstring[]

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.

reference_image_urlsstring[]

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.

imagefile

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.

nintegermặc định: 1

Số lượng hình ảnh cần tạo (1-10, tùy thuộc vào mô hình).

sizestring

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.

aspect_ratiostring

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.

resolutionstring

Độ 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.

qualitystring

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.

output_formatstring

Đị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.

svgobject

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.

frame_countintegermặc định: 9

Số lượng khung hình GIF, từ 2 đến 16. Chỉ dùng với output_format: "gif".

frame_duration_msintegermặc định: 200

Thờ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".

response_formatstring

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 trong data[].url khi 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 trong data[].url.
  • url: mỗi hình ảnh chỉ nằm trong data[].url.
  • b64_json: mỗi hình ảnh chỉ nằm trong data[].b64_json dướ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.

asyncbooleanmặc định: 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.

stylestring

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.

userstring

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

createdinteger

Unix timestamp thời điểm tạo.

dataarray

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 khi response_format là b64_json. Khi response_format bị 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 khi response_format là 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ề
usageobject

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.

svg_usageobject

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.

createdinteger

Unix timestamp thời điểm tạo.

task_idstring

Mã định danh tác vụ duy nhất để thực hiện polling.

statusstring

Trạng thái ban đầu: pending.

poll_urlstring

URL tương đối để poll kết quả, ví dụ: /v1/tasks/{id}.

dataarray

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
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"
  }'
Python
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)
JavaScript
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
<?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:

CodeNguyên nhân
unsupported_parameterMô hình không liệt kê trường này, hoặc stream là true
unsupported_operationMô hình không có operation này
unsupported_endpointThao 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_modeMô hình không hỗ trợ async: true
invalid_resolution, invalid_aspect_ratio, invalid_parameter_value, too_many_itemsMộ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_contractMộ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_longLời nhắc dài hơn mức mô hình chấp nhận
request_too_large, file_too_largeDung 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
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

Header

X-TokenLab-Delivery-Policy?string

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"
Idempotency-Key?string

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.

Độ dài1 <= length <= 255

Nội dung yêu cầu

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json