Hướng dẫn API GPT-Image-2

GPT-Image-2 — OpenAI Image Generation API

Truy cập model tạo ảnh mới nhất của OpenAI thông qua API hợp nhất của TokenHub. Tương thích hoàn toàn với OpenAI, trả về đồng bộ (không cần polling), nhiều kích thước lên đến 4K, các mức quality và định dạng đầu ra PNG/JPEG/WebP. Hỗ trợ cả text-to-image (t2i) và chỉnh sửa image-to-image (i2i, ghép nhiều ảnh & inpainting). Hướng dẫn này sẽ giúp bạn tích hợp đầy đủ.

Text → ImageImage → Image (i2i)OpenAI-CompatibleSynchronousUp to 4KToken-based

1Lấy API Key của bạn

Truy cập tokenhub.store để tạo tài khoản (hỗ trợ đăng nhập GitHub / Google)
Vào Dashboard → API Keys, nhấn "Create New Key"
Vào Dashboard → Billing để nạp Credits (1 Credit = $1 USD)
Sao chép API Key của bạn (định dạng: th-xxxxxxxxxxxx...)

⚠️ API Key chỉ được hiển thị một lần khi tạo. Hãy lưu trữ an toàn. Nếu mất, bạn sẽ cần tạo key mới.

2Tổng quan API

Base URL

https://tokenhub.store/api/v1

Xác thực

Tất cả request đều yêu cầu API Key trong header:

Header

Authorization: Bearer th-your-api-key

Endpoints (đồng bộ, tương thích OpenAI)

POST

/images/generations

Text-to-image. Tạo ảnh từ prompt văn bản.

POST

/images/edits

Chỉnh sửa image-to-image. Hỗ trợ chỉnh sửa một ảnh, ghép nhiều ảnh và inpainting tùy chọn bằng mask.

3Giá

Cấp	Giá	Phạm vi độ phân giải
1K	$0.125 / image	Cạnh dài nhất ≤ 1536 px (ví dụ 1024×1024, 1024×1536)
2K	$0.250 / image	Cạnh dài nhất ≤ 2048 px (ví dụ 2048×2048)
4K	$0.500 / image	Cạnh dài nhất > 2048 px (ví dụ: 4096×4096)

Giá cố định theo từng ảnh dựa trên bậc độ phân giải đầu ra (xác định theo cạnh dài nhất của kích thước). n ảnh = đơn giá × n. Các yêu cầu thất bại sẽ không bị tính phí.

Quy đổi bậc theo cạnh dài nhất: ≤ 1536 px → 1K ($0.125), ≤ 2048 px → 2K ($0.250), > 2048 px → 4K ($0.500). Ví dụ: 1024×1024 và 1024×1536 đều là 1K; 2048×2048 là 2K; 4096×4096 là 4K.

4Tham số yêu cầu

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
model	string	Bắt buộc	—	ID model. Dùng "openai/gpt-image-2" (hoặc dạng rút gọn "gpt-image-2").
prompt	string	Bắt buộc	—	Prompt văn bản mô tả ảnh cần tạo.
n	integer	Tùy chọn	1	Số lượng ảnh cần tạo (1–10).
size	string	Tùy chọn	1024x1024	Kích thước đầu ra. Tùy chọn: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840, auto.
quality	string	Tùy chọn	auto	Chất lượng tạo ảnh. Tùy chọn: auto, low, medium, high. Chất lượng cao hơn sẽ tiêu tốn nhiều tokens hơn.
format	string	Tùy chọn	png	Định dạng ảnh đầu ra. Tùy chọn: png, jpeg, webp.

Trường bổ sung cho /images/edits (i2i)

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
image	file / string \| array	Bắt buộc	—	Ảnh đầu vào để chỉnh sửa. Chấp nhận file qua multipart, hoặc URL / dữ liệu base64 dưới dạng JSON. Có thể cung cấp nhiều ảnh để ghép thành một ảnh đầu ra.
mask	file / string	Tùy chọn	—	Mask inpainting tùy chọn. Vùng trong suốt sẽ được tạo lại; vùng không trong suốt sẽ được giữ nguyên.
input_fidelity	string	Tùy chọn	low	Mức độ giữ nguyên đầu vào. Tùy chọn: low, high. Dùng high để giữ danh tính/bố cục; dùng low cho các biến đổi mạnh hơn.
output_format	string	Tùy chọn	png	Bí danh của 'format' cho endpoint chỉnh sửa. Tùy chọn: png, jpeg, webp.
output_compression	integer	Tùy chọn	100	Mức nén 0–100 (chỉ cho jpeg / webp).

5Ví dụ curl hoàn chỉnh

bash

curl -X POST https://tokenhub.store/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "A serene Japanese garden at sunset, koi pond reflections, cherry blossoms, soft cinematic lighting, ultra-detailed"
  }'

Phản hồi:

json

{
  "created": 1740000000,
  "data": [
    {
      "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

6Ví dụ Python đầy đủ

python

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://tokenhub.store/api/v1",
)

result = client.images.generate(
    model="openai/gpt-image-2",
    prompt="A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
    n=1,
    size="1536x1024",
    quality="high",
)

image_url = result.data[0].url
print("Image URL:", image_url[:80], "...")

7Ví dụ JavaScript / Node.js đầy đủ

javascript

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://tokenhub.store/api/v1",
});

const result = await client.images.generate({
  model: "openai/gpt-image-2",
  prompt: "A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
  n: 1,
  size: "1536x1024",
  quality: "high",
});

console.log("Image URL:", result.data[0].url.slice(0, 80), "...");

8Mẹo sử dụng

Prompt bằng tiếng Anh thường cho kết quả tốt nhất; tiếng Trung cũng được hỗ trợ.
Response data[].url có thể là URL https thuần hoặc data URI (base64). Hãy xử lý cả hai trường hợp khi lưu xuống đĩa.
Để giảm chi phí, hãy dùng chất lượng low/medium cho bản nháp và chỉ dùng high/kích thước 4K cho đầu ra cuối cùng.
Endpoint là đồng bộ — không có task id, không polling. Một yêu cầu thường hoàn tất trong 5–30 giây tùy kích thước và chất lượng.
Đặt HTTP timeout phía client ≥ 120s để tránh bị ngắt kết nối sớm với ảnh lớn.

9FAQ

Sẵn sàng bắt đầu?

Đăng ký TokenHub và bắt đầu dùng GPT-Image-2 API ngay bây giờ

Lấy API Key Nạp Credits