Tạo hình ảnh

Sprelay cung cấp POST /v1/images/generations. Tổ hợp gpt-image-2, 1024x1024, low và đầu ra Base64 đã được kiểm tra bằng khóa tạm thời có hạn mức thấp. Chỉnh sửa hình ảnh chưa được ghi lại vì chưa được xác minh.

Trước khi bắt đầu

1. Xác nhận gpt-image-2 trong Danh mục mô hình.
2. Chọn nhóm hình ảnh chuyên dụng hiện tại khi tạo khóa.
3. Đặt hạn mức nhỏ riêng cho khóa đó.
4. Chỉ tạo một hình chất lượng thấp trong lần kiểm tra đầu tiên.

curl

# Lưu phản hồi JSON lớn vào tệp thay vì làm đầy terminal.
curl https://sprelaytoken.com/v1/images/generations \
  -H "Authorization: Bearer $SPRELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Một hình tròn xanh phẳng, đơn giản, nằm giữa nền trắng.",
    "n": 1,
    "size": "1024x1024",
    "quality": "low"
  }' \
  --output response.json

prompt mô tả hình ảnh, n: 1 yêu cầu một kết quả, còn size và quality dùng tổ hợp chi phí thấp đã kiểm tra. JSON không thể chứa chú thích.

Giải mã hình đầu tiên trên hệ thống có jq và base64:

# Trích Base64 từ JSON, giải mã và ghi thành tệp PNG.
jq -r '.data[0].b64_json' response.json | base64 --decode > sprelay-image.png

Python

# base64 giải mã hình; requests gửi HTTP; os đọc khóa.
import base64
import os
import requests

# Tạo hình có thể lâu hơn văn bản, vì vậy dùng thời gian chờ 180 giây.
response = requests.post(
    "https://sprelaytoken.com/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['SPRELAY_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-image-2",
        "prompt": "Một hình tròn xanh phẳng, đơn giản, nằm giữa nền trắng.",
        "n": 1,
        "size": "1024x1024",
        "quality": "low",
    },
    timeout=180,
)

# Dừng với 4xx/5xx trước khi cố giải mã phản hồi lỗi.
response.raise_for_status()
payload = response.json()
image_bytes = base64.b64decode(payload["data"][0]["b64_json"])

# wb ghi byte đã giải mã thành tệp PNG nhị phân.
with open("sprelay-image.png", "wb") as image_file:
    image_file.write(image_bytes)

PowerShell

# Đọc khóa từ môi trường PowerShell hiện tại.
$headers = @{
  Authorization = "Bearer $env:SPRELAY_API_KEY"
  "Content-Type" = "application/json"
}

# Yêu cầu một hình chất lượng thấp đã kiểm tra để kiểm soát chi phí lần đầu.
$body = @{
  model = "gpt-image-2"
  prompt = "Một hình tròn xanh phẳng, đơn giản, nằm giữa nền trắng."
  n = 1
  size = "1024x1024"
  quality = "low"
} | ConvertTo-Json

# PowerShell tự động phân tích phản hồi JSON.
$response = Invoke-RestMethod `
  -Uri "https://sprelaytoken.com/v1/images/generations" `
  -Method Post `
  -Headers $headers `
  -Body $body `
  -TimeoutSec 180

# Giải mã hình Base64 đầu tiên và lưu trong thư mục hiện tại.
$bytes = [Convert]::FromBase64String($response.data[0].b64_json)
[IO.File]::WriteAllBytes("sprelay-image.png", $bytes)

Dữ liệu hình ảnh Base64 rất lớn. Hãy giải mã hoặc tải lên ngay; không ghi toàn bộ giá trị vào nhật ký ứng dụng. Trước khi thử lại một yêu cầu hết thời gian chờ, hãy kiểm tra nhật ký sử dụng vì hình ở upstream có thể đã được tạo và tính phí.