Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Sử dụng tài liệu model hình ảnh của CometAPI bằng cách chọn định dạng request phù hợp với quy trình làm việc của bạn. Các endpoint hình ảnh tương thích OpenAI bao phủ những luồng tạo và chỉnh sửa phổ biến; các trang theo từng nhà cung cấp bao phủ những hệ thống hình ảnh theo tác vụ.

Chọn một image API

Image Generations

Tạo hình ảnh bằng request tương thích OpenAI.

Image Editing

Chỉnh sửa hình ảnh bằng request tương thích OpenAI.

Gemini image generation

Tạo hoặc chỉnh sửa hình ảnh với định dạng Gemini.

Midjourney quick start

Gửi và thăm dò các tác vụ hình ảnh Midjourney.

Flux Generate Image

Tạo hình ảnh Flux thông qua CometAPI.

Bria Generate Image

Sử dụng các công cụ tạo hình ảnh Bria.

Tạo một hình ảnh

Sử dụng một model ID có khả năng xử lý hình ảnh từ trang Models hoặc thư mục model. Các ví dụ bên dưới gọi Image Generations API tương thích OpenAI.
Các ví dụ này dùng placeholder your-image-model-id. Hãy thay nó bằng một model ID hình ảnh khả dụng từ trang Models hoặc thư mục model trước khi bạn chạy request.
Mở Image Generations để sử dụng playground và schema endpoint.
import os
import requests

response = requests.post(
    "https://api.cometapi.com/v1/images/generations",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "your-image-model-id",
        "prompt": "A clean product photo of a glass teapot on a white table",
        "size": "1024x1024",
    },
    timeout=120,
)

response.raise_for_status()
result = response.json()
print(result["data"][0].keys())

Ví dụ phản hồi

Một phản hồi thành công có thể trông như sau. Tùy thuộc vào model được chọn, mỗi mục có thể chứa một hình ảnh base64 hoặc một URL kết quả:
{
  "created": 1779872000,
  "background": "opaque",
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ],
  "output_format": "png",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 19,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 19
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 215
  }
}

Bản ghi model ví dụ

Phản hồi danh mục model ví dụ này hiển thị lớp bao ngoài /api/models và hình dạng của một bản ghi model hình ảnh. Đây không phải là danh sách model đầy đủ.
cURL
curl https://api.cometapi.com/api/models
{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1776391310,
      "id": "your-image-model-id",
      "code": "your-image-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example image model",
      "model_type": "image",
      "features": [
        "text-to-image"
      ],
      "endpoints": "{\n  \"openai-image\": {\n    \"path\": \"/v1/images/generations\",\n    \"method\": \"POST\"\n  }\n}",
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 4,
        "output": 24,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}

Lỗi thường gặp

Chọn một model có khả năng xử lý hình ảnh từ trang Models.
Sử dụng kích thước mà endpoint hình ảnh đã chọn chấp nhận.
Tải xuống các tài sản đã tạo trước khi các liên kết từ nhà cung cấp hết hạn.
Sử dụng URL hình ảnh hoặc tệp nhỏ hơn thay vì payload base64 lớn.
Kiểm tra cả trường b64_jsonurl vì hình dạng output có thể khác nhau theo model.

Mã lỗi và chiến lược retry

Không retry cho đến khi prompt, kích thước hoặc đầu vào hình ảnh được sửa.
Không retry cho đến khi API key hiện diện và hợp lệ.
Kiểm tra base URL, path và model ID trước khi retry.
Giảm kích thước tải lên trước khi retry.
Retry với exponential backoff và giảm mức độ đồng thời.
Retry với backoff cho các lỗi nhà cung cấp hoặc dịch vụ mang tính tạm thời.

Giá và thư mục model

Models page

Đọc cách CometAPI hiển thị model ID trong tài liệu.

Model directory

Duyệt khả năng sẵn có và năng lực của model.

Pricing

Kiểm tra giá trước khi bạn gọi một model.
Last modified on May 28, 2026