Tạo hình ảnh

POST /v1/images/generations

Hỗ trợ thả vào tương thích với OpenAI images.generate SDK. Các tham số dành riêng cho nhà cung cấp hoạt động cùng với các tham số tiêu chuẩn — phần phụ trợ chuyển tiếp những gì mỗi mô hình hiểu được.

Thông số chung

Ví dụ cơ bản

curl https://api.airforce/v1/images/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-dev",
    "prompt": "A cute baby sea otter floating on its back",
    "n": 1,
    "response_format": "url"
  }'

Hình dạng phản hồi

{
  "created": 1715000000,
  "data": [{
    "url": "https://cdn.api.airforce/images/abc123.png"
  }]
}

Biến thể phát trực tuyến

Vượt qua sse: true khi ủy quyền thông qua phần mềm trung gian có thời gian chờ nhàn rỗi chặt chẽ. Phản hồi là một sự kiện SSE có JSON hoàn chỉnh, sau đó [DONE].

data: {"created":1715000000,"data":[{"url":"https://cdn.api.airforce/images/abc123.png"}]}

data: [DONE]

Hình ảnh thành hình ảnh & tài liệu tham khảo

Mô hình với image_caps.max_input_images > 0 chấp nhận hình ảnh tham khảo. Chuyển URL hoặc dữ liệu được mã hóa base64.

curl https://api.airforce/v1/images/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-dev",
    "prompt": "Same character, now in a snowy forest",
    "aspect_ratio": "16:9",
    "input_images": [
      {"url": "https://example.com/character.jpg"}
    ]
  }'

Thông số dành riêng cho mô hình

Ngoài các thông số chung ở trên, các dòng mô hình riêng lẻ còn chấp nhận các tính năng bổ sung. Các tham số không xác định được chuyển tiếp lên thượng nguồn theo nguyên trạng, do đó, mọi nút điều chỉnh dành riêng cho nhà cung cấp trong tương lai cũng hoạt động mà không cần cập nhật SDK.

Flux

flux-2-klein-4b, flux-2-klein-9b, flux-2-dev

Nano-Banana

nano-banana-2, nano-banana-2-search, nano-banana-pro

Suno (music via /v1/images/generations)

suno-v4.5, suno-v5 — Suno historically routes through this endpoint. Native music API at /v1/audio/music is preferred for new code.

Khám phá khả năng

Mỗi mẫu hình ảnh lộ ra image_caps TRÊN /v1/models để khách hàng có thể xác thực thông tin đầu vào trước khi gửi: