GPT Image 1

ID:openai/gpt-image-1

API tạo hình ảnh GPT Image 1 của OpenAI — mô hình hình ảnh GPT-4o gốc đầu tiên của OpenAI với khả năng tuân thủ prompt mạnh mẽ và tối đa 5 hình ảnh tham chiếu.

Chuyển văn bản thành hình ảnhChỉnh sửa hình ảnhHình ảnh tham chiếu

Tổng quan

Xác thực

Tất cả request API yêu cầu khóa API hợp lệ được truyền qua header Authorization sử dụng scheme Bearer.

Bắt đầu nhanh

Thông tin xác thực

Đặt biến môi trường RUNBASE_API_KEY.

Shell

export RUNBASE_API_KEY=your-api-key

Tạo lượt chạy

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

Lượt chạy

Các lượt chạy được xử lý bất đồng bộ. Gửi request, sau đó poll để lấy kết quả.

Tạo lượt chạy

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

Lấy trạng thái lượt chạy

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Lấy kết quả

Poll endpoint trạng thái cho đến khi status là "succeeded", sau đó đọc output.urls từ response.

Schema đầu vào

Tham số	Loại	Bắt buộc	Mô tả
prompt	string	Bắt buộc	Prompt
aspect_ratio	string	Tùy chọn	Aspect ratioTùy chọn: `1:13:22:3`
image_urls	string[]	Tùy chọn	Reference images

Schema đầu ra

Trường	Loại	Mô tả
urls	string[]	URL đầu ra đã tạo

Lỗi

API sử dụng mã trạng thái HTTP tiêu chuẩn để biểu thị thành công hoặc thất bại.

Mã trạng thái	Mô tả
400	Ungültige Anfrage – fehlende oder fehlerhafte Parameter
401	Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel
402	Unzureichendes Guthaben
403	Zugriff verweigert – IP nicht erlaubt oder Ausgabenlimit des API-Schlüssels überschritten
404	Ausführung nicht gefunden
429	Rate-Limit überschritten
500	Interner Serverfehler