Tham Khảo API
Hình Ảnh
Tạo hình ảnh từ prompt văn bản bằng các mô hình tạo hình ảnh hàng đầu thông qua endpoint tương thích OpenAI.
Endpoint
http
POST https://api.tokspan.com/v1/images/generationsTham Số Yêu Cầu
| Tham Số | Kiểu | Bắt Buộc | Mô Tả |
|---|---|---|---|
| model | string | Có | ID mô hình (ví dụ: dall-e-3, dall-e-2) |
| prompt | string | Có | Mô tả văn bản của hình ảnh mong muốn (tối đa 4000 ký tự) |
| n | integer | Không | Số lượng hình ảnh cần tạo. Mặc định: 1 |
| size | string | Không | Độ phân giải hình ảnh. Kích thước hỗ trợ tùy thuộc vào mô hình — dall-e-2: 256x256, 512x512, 1024x1024; dall-e-3: 1024x1024, 1792x1024, 1024x1792 |
| quality | string | Không | "standard" hoặc "hd" (trên các mô hình hình ảnh được hỗ trợ) |
| response_format | string | Không | "url" (mặc định) hoặc "b64_json" |
| style | string | Không | "vivid" (mặc định) hoặc "natural" (trên các mô hình hình ảnh được hỗ trợ) |
Ví Dụ
python
from openai import OpenAI
client = OpenAI(
api_key="sk-your-key",
base_url="https://api.tokspan.com/v1",
)
response = client.images.generate(
model="MODEL_NAME",
prompt="A serene mountain lake at sunset, digital art style",
n=1,
size="1024x1024",
)
print(response.data[0].url)Chỉnh Sửa Hình Ảnh
http
POST https://api.tokspan.com/v1/images/edits| Tham Số | Kiểu | Bắt Buộc | Mô Tả |
|---|---|---|---|
| model | string | Có | ID mô hình (ví dụ: dall-e-3, dall-e-2) |
| image | file | Có | Hình ảnh đầu vào cần chỉnh sửa, dưới dạng tải lên tệp multipart (PNG, JPEG, WebP). |
| prompt | string | Có | Mô tả văn bản của chỉnh sửa mong muốn (ví dụ: "thêm một chiếc thuyền đỏ vào hồ"). |
| mask | file | Không | Hình ảnh mask tùy chọn cho biết khu vực cần chỉnh sửa. Các vùng trong suốt được giữ nguyên. |
| n | integer | Không | Số lượng hình ảnh cần tạo. Mặc định: 1 |
| size | string | Không | Độ phân giải hình ảnh. Kích thước hỗ trợ tùy thuộc vào mô hình — dall-e-2: 256x256, 512x512, 1024x1024; dall-e-3: 1024x1024, 1792x1024, 1024x1792 |
| response_format | string | Không | "url" (mặc định) hoặc "b64_json" |
python
from openai import OpenAI
client = OpenAI(
api_key="sk-your-key",
base_url="https://api.tokspan.com/v1",
)
response = client.images.edit(
model="MODEL_NAME",
image=open("input.png", "rb"),
prompt="Add a red boat to the lake",
)
print(response.data[0].url)Mô Hình Khả Dụng
Các mô hình tạo hình ảnh được hỗ trợ bao gồm các mô hình hàng đầu từ OpenAI và các nhà cung cấp khác. Xem trang Mô Hình để biết danh sách mô hình hiện tại và giá cả.