Chuyển đến nội dung chính
OrcaRouter cung cấp tạo hình ảnh qua hai đường, tùy mô hình bạn chọn:
  1. /v1/images/generations — định dạng OpenAI image API. Phù hợp nhất cho các mô hình tạo ảnh chuyên dụng (họ thay thế DALL-E, Imagen, Grok Imagine).
  2. /v1/chat/completions — tạo ảnh theo kiểu chat. Phù hợp nhất khi bạn muốn mô hình trả về văn bản và hình ảnh trong cùng một lượt (họ nano-banana / “imagine” của Gemini).

​
Đường 1: API hình ảnh chuyên dụng

/v1/images/generations theo định dạng OpenAI image API. Các họ mô hình phục vụ endpoint này:
  • OpenAI: openai/gpt-image-1, openai/gpt-image-1-mini, openai/gpt-image-1.5
  • Google Imagen: google/imagen-4.0-fast-generate-001, google/imagen-4.0-generate-001, google/imagen-4.0-ultra-generate-001
  • xAI: grok/grok-imagine-image, grok/grok-imagine-image-pro
curl https://api.orcarouter.ai/v1/images/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "prompt": "A cat astronaut on Mars, photorealistic",
    "size": "1024x1024"
  }'

​
Đường 2: tạo ảnh qua chat completions

Một số mô hình Gemini có thể trả về hình ảnh như một phần của lượt chat completion thông thường. Khi bạn chọn một trong các mô hình này, OrcaRouter tự động yêu cầu upstream phát ra cả văn bản và hình ảnh trong phản hồi:
  • google/gemini-2.5-flash-image
  • google/gemini-3-pro-image-preview
  • google/gemini-3.1-flash-image-preview

​
Ví dụ

from openai import OpenAI

client = OpenAI(base_url="https://api.orcarouter.ai/v1", api_key="sk-orca-...")

resp = client.chat.completions.create(
    model="google/gemini-2.5-flash-image",
    messages=[{"role": "user", "content": "Draw a watercolour of a foggy harbor at dawn."}],
)

# resp.choices[0].message.content chứa văn bản + một image data URL
# hoặc khối inline_data, tùy cách SDK tuần tự hóa. Kiểm tra phản hồi
# thô nếu SDK của bạn không đưa ra hình ảnh trực tiếp.
Các mô hình này không thể gọi qua /v1/images/generations — hãy dùng chat completions cho chúng.

​
Xem thêm