Hình ảnh

Các endpoint tạo ảnh từ văn bản và chỉnh sửa ảnh theo định dạng OpenAI Images. Các mô hình khả dụng (DALL·E 3, GPT-Image, Seedream, v.v.) thay đổi tùy kênh — các trường dưới đây là những trường phổ biến.

Tạo hình ảnh

POST /v1/images/generations

RequestREQUEST

POSThttps://test.kailin.com.cn/v1/images/generations

The returned `url` is temporary — re-host promptly. b64_json mode returns large payloads and may render slowly.

API KeyStored only in your browser, never uploaded

Body (JSON){ "model": "dall-e-3", "prompt": "A cyberpunk city at night, neon lights, reflections after rain", "size": "1024x1024" }

ResponseRESPONSE

Fill in the request and hit Send — the response shows up here

Yêu cầu

curl https://test.kailin.com.cn/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A cyberpunk city at night, neon lights, reflections after rain",
    "n": 1,
    "size": "1024x1792"
  }'

Thân yêu cầu

Tham số	Kiểu	Bắt buộc	Mô tả
model	string	Không	Mặc định là dall-e-2; cũng có dall-e-3, gpt-image-1, v.v.
prompt	string	Có	Mô tả hình ảnh — tối đa 4000 ký tự trên DALL·E 3
n	integer	Không	Số lượng ảnh 1–10 (DALL·E 3 chỉ hỗ trợ 1)
size	string	Không	Độ phân giải: 1024x1024 / 1792x1024 / 1024x1792 (DALL·E 3); 256/512/1024x1024 (DALL·E 2); auto/1024x1536/1536x1024 (GPT-Image)
quality	string	Không	standard / hd (DALL·E 3); low/medium/high/auto (GPT-Image)
response_format	string	Không	url (mặc định) hoặc b64_json (GPT-Image luôn trả về b64)
style	string	Không	Chỉ dành cho DALL·E 3: vivid / natural
seed	integer	Không	Seed ngẫu nhiên

Phản hồi

{
  "created": 1730000000,
  "data": [
    {
      "url": "https://oss.example.com/img/abc.png",
      "revised_prompt": "A cyberpunk city at night…"
    }
  ]
}

Với response_format: "b64_json", data[].b64_json chứa dữ liệu ảnh Base64. Kết quả url trỏ tới một vị trí tạm thời phía upstream — hãy tải về và lưu trữ lại sớm.

Chỉnh sửa hình ảnh

POST /v1/images/edits

Tải ảnh gốc lên dưới dạng multipart/form-data và chỉnh sửa qua prompt (GPT-Image / DALL·E 2 hỗ trợ):

curl https://test.kailin.com.cn/v1/images/edits \
  -H "Authorization: Bearer sk-your-token" \
  -F "model=gpt-image-1" \
  -F "prompt=Replace the background with a seaside at dusk" \
  -F "image=@/path/to/input.png"

Trường	Kiểu	Bắt buộc	Mô tả
image	file	Có	Ảnh nguồn (png/jpeg/webp; GPT-Image chấp nhận nhiều image[])
prompt	string	Có	Chỉ dẫn chỉnh sửa
mask	file	Không	Mặt nạ (mask) với các vùng trong suốt là vùng được chỉnh sửa (DALL·E 2)
model	string	Không	gpt-image-1 / dall-e-2
n / size / quality	-	Không	Giống endpoint tạo ảnh

Các endpoint cũ (Legacy)

POST /v1/images/variations (biến thể ảnh, DALL·E 2) và POST /v1/edits (đường dẫn cũ) cũng được proxy — tham số giống như trên. Chỉ dùng chúng cho các codebase cũ.

Mẹo

Các mô hình như Nano Banana (Gemini images) cũng hoạt động được qua định dạng OpenAI — chỉ cần đặt model thành tên tương ứng; các tham số không nhận diện được sẽ được chuyển thẳng tới upstream.