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": "nano-banana-2",
    "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://.../image.jpeg"
  }]
}

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://.../image.jpeg"}]}

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": "nano-banana-2",
    "prompt": "Same character, now in a snowy forest",
    "aspect_ratio": "16:9",
    "input_images": [
      {"url": "https://example.com/character.jpg"}
    ]
  }'

Chỉnh sửa ảnh

Endpoint chỉnh sửa tương thích OpenAI. Gửi ảnh nguồn dưới dạng tệp multipart, giống cách SDK OpenAI làm với images.edit, hoặc gửi body JSON ở trên kèm input_images. Nó đi cùng đường với /v1/images/generations: cùng mô hình, giá và định dạng phản hồi.

curl https://api.airforce/v1/images/edits \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -F "model=nano-banana-2" \
  -F "prompt=Same character, now in a snowy forest" \
  -F "[email protected]" \
  -F "aspect_ratio=16:9"

from openai import OpenAI

client = OpenAI(base_url="https://api.airforce/v1", api_key="sk-air-YOUR_API_KEY")

with open("character.png", "rb") as image:
    result = client.images.edit(
        model="nano-banana-2",
        image=image,
        prompt="Same character, now in a snowy forest",
    )
print(result.data[0].url)

Tối đa 16 ảnh đầu vào mỗi yêu cầu, mỗi ảnh 25 MB; giới hạn riêng của mô hình nằm ở image_caps.max_input_images. Yêu cầu không có ảnh đầu vào bị từ chối với mã 400 thay vì trở thành lệnh tạo ảnh từ văn bản. Mỗi ảnh đầu vào có thể làm tăng giá, như trên trang mô hình.

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.

Nano-Banana

nano-banana-2, nano-banana-pro

Suno (music)

suno-v4.5, suno-v5 và suno-v5.5 từng được chấp nhận tại endpoint này. Giờ chúng thuộc API nhạc gốc tại /v1/audio/music — các lệnh gọi ở đây bị từ chối với `wrong_endpoint`.

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:

Giá hình ảnh không nằm ở image_caps — hãy dùng các trường giá của model trên /v1/models để biết chi phí.