API tham khảo

Tạo ảnh gpt-image-2

Tạo ảnh bằng gpt-image-2 qua endpoint OpenAI-compatible, phản hồi trả về ảnh dạng base64.

Tạo ảnh từ mô tả văn bản bằng model `gpt-image-2`, dùng đúng chuẩn OpenAI nên mọi SDK tương thích OpenAI đều gọi được.

Endpoint

POST
POST https://cheapkeyai.shop/v1/images/generations

Yêu cầu

TênVị tríBắt buộcMô tả
Authorizationheader`Bearer sk-your-api-key-here`
Content-Typeheader`application/json`
modelbody`gpt-image-2`
promptbodyMô tả ảnh muốn tạo
sizebodyKhôngKích thước ảnh, ví dụ `1024x1024`
qualitybodyKhôngMức chất lượng, ví dụ `low`, `medium`, `high`
nbodyKhôngSố ảnh cần tạo, mặc định `1`

Ví dụ

cURL
curl https://cheapkeyai.shop/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A children\'s book drawing of a veterinarian using a stethoscope to listen to the heartbeat of a baby otter.",
    "size": "1024x1024",
    "quality": "low",
    "n": 1
  }'

Phản hồi 200

Response
{
  "created": 1677652288,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAAA..."
    }
  ]
}

Lưu ảnh ra file

Vì phản hồi là base64, bạn cần decode trước khi lưu.

Decode base64 → PNG
curl -s https://cheapkeyai.shop/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"a cute cat","size":"1024x1024","n":1}' \
  | jq -r '.data[0].b64_json' | base64 -d > output.png
Python
import base64
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key-here",
    base_url="https://cheapkeyai.shop/v1",
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="a cute cat",
    size="1024x1024",
    n=1,
)

with open("output.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

Lỗi 400

Sai tham số hoặc không qua validation
{
  "error": {
    "message": "Invalid request (request id: 20260805120000123456789AbCdEfGh)",
    "type": "new_api_error"
  }
}