Tạo Hình Ảnh

​

Khi Nào Sử Dụng Mỗi Endpoint

​

Chọn Một Mô Hình

curl "https://api.tokenlab.sh/v1/models?recommended_for=image" \
  -H "Authorization: Bearer sk-your-api-key"

• Hoạt động được hỗ trợ, chẳng hạn như text-to-image, image-to-image, hoặc image-edit.
• Endpoint yêu cầu mà mô hình mong đợi.
• Hình dạng nào để sử dụng cho các tham chiếu, chẳng hạn như image_url, image_urls, reference_image_urls, đa phần image, hoặc JSON images[].
• Liệu mô hình có chấp nhận size, aspect_ratio, resolution, quality, background, output_format, hoặc response_format hay không.

​

Quy Tắc Hình Dạng Yêu Cầu

• Các yêu cầu kiểu gpt-image-2 sử dụng các trường size, quality, và chỉnh sửa giống như OpenAI. Với cả tạo và chỉnh sửa ảnh, background chấp nhận auto hoặc opaque; không hỗ trợ transparent. Bỏ qua các trường tùy chọn khi bạn muốn mô hình hoặc TokenLab sử dụng các giá trị mặc định tự động.
• Các gia đình hình ảnh Gemini và Nano Banana thường sử dụng aspect_ratio; chỉ gửi resolution khi hợp đồng mô hình tiết lộ nó.
• Hình ảnh Nano Banana thành hình ảnh thuộc về /v1/images/generations với operation: "image-to-image" và các URL hình ảnh tham chiếu.
• /v1/images/generations không chấp nhận images[] hoặc file_id ở cấp độ cao; đó là các hình dạng quy trình chỉnh sửa.
• Các tham chiếu hình ảnh từ xa phải là các URL công khai http hoặc https. Không gửi các URL mạng riêng, thông tin xác thực nhúng, đoạn URL, hoặc các URL đã ký có thể hết hạn trước khi xử lý bắt đầu.

​

Ví Dụ Chuyển Đổi Văn Bản Thành Hình Ảnh

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Một bức ảnh sản phẩm sạch của một chiếc cốc cà phê bằng gốm trên một cái bàn óc chó",
    "size": "1024x1024",
    "response_format": "url"
  }'

​

Ví Dụ Hình Ảnh Tham Chiếu

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "operation": "image-to-image",
    "prompt": "Giữ nguyên hình dạng sản phẩm, thay đổi nền thành một thiết lập studio sáng",
    "image_urls": ["https://example.com/input/product.png"],
    "aspect_ratio": "1:1"
  }'

​

Xử Lý Kết Quả

• Các phản hồi đồng bộ trả về data[] cuối cùng với url hoặc b64_json.
• Các phản hồi không đồng bộ trả về id, task_id, status, và thường là poll_url.
• Ưu tiên poll_url khi nó có mặt. Nếu bạn cần một tuyến đường cố định, hãy kiểm tra GET /v1/tasks/{id}.
• Sử dụng các yêu cầu đồng bộ khi bạn cần cụ thể b64_json; các kết quả hình ảnh không đồng bộ có định hướng URL.

curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer sk-your-api-key"

​

Danh Sách Kiểm Tra Sản Xuất

• Xác thực đầu vào của người dùng trước khi gọi TokenLab: độ dài lời nhắc, số lượng hình ảnh, khả năng tiếp cận URL, và loại tệp.
• Đặt thời gian chờ HTTP đủ cao cho các yêu cầu đồng bộ độ phân giải cao. Sử dụng chế độ không đồng bộ khi có sẵn cho công việc dài.
• Lưu trữ request_id, task_id, poll_url, mô hình, endpoint, và hình dạng yêu cầu đã được làm sạch để hỗ trợ.
• Khi khách hàng hết thời gian chờ, kiểm tra xem một nhiệm vụ đã được tạo ra trước khi thử lại yêu cầu tạo.
• Đối chiếu chi phí với hồ sơ sử dụng và billing_transaction_id khi có mặt, không phải với ID nhiệm vụ của nhà cung cấp.

​

Lỗi Thường Gặp

​

Tham Khảo API