跳轉到主要內容

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.

請依照符合您工作流程的請求格式來使用 CometAPI 圖像模型文件。與 OpenAI 相容的圖像端點涵蓋常見的生成與編輯流程；供應商專屬頁面則涵蓋以任務為導向的圖像系統。

​
選擇圖像 API

圖像生成

使用與 OpenAI 相容的請求生成圖像。

圖像編輯

使用與 OpenAI 相容的請求編輯圖像。

Gemini 圖像生成

使用 Gemini 格式生成或編輯圖像。

Midjourney 快速開始

提交並輪詢 Midjourney 圖像任務。

Flux 生成圖像

透過 CometAPI 生成 Flux 圖像。

Bria 生成圖像

使用 Bria 圖像生成工具。

​
生成圖像

請從模型頁面或模型目錄選用支援圖像的 model ID。以下範例會呼叫與 OpenAI 相容的圖像生成 API。
這些範例使用預留位置 your-image-model-id。在執行請求前，請將其替換為模型頁面或模型目錄中的可用圖像 model ID。
開啟圖像生成以使用 playground 和端點結構描述。
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())

​
回應範例

成功的回應可能如下所示。依所選模型而定，每個項目可能包含 base64 圖像或結果 URL： 
{
  "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
  }
}

​
範例模型記錄

此範例模型目錄回應顯示 /api/models 的封裝格式，以及一個圖像模型記錄的結構。這不是完整的模型清單。
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
      }
    }
  ]
}

​
常見錯誤

請從模型頁面選擇支援圖像的模型。
請使用所選圖像端點接受的尺寸。
請在供應商連結過期前下載生成的資產。
請使用圖像 URL 或較小的檔案，而不是大型 base64 payload。
請同時檢查 b64_json 與 url 欄位，因為輸出結構可能因模型而異。

​
錯誤代碼與重試策略

在修正 prompt、尺寸或圖像輸入之前，請不要重試。
在 API key 已提供且有效之前，請不要重試。
重試前請檢查 base URL、路徑與 model ID。
重試前請縮減上傳大小。
請使用指數退避進行重試，並降低並行數。
針對暫時性的供應商或服務錯誤，請使用退避策略重試。
如需實作模式，請參閱錯誤代碼與重試策略以及速率限制與並行。

​
定價與模型目錄

模型頁面

了解 CometAPI 如何在文件中提供 model IDs。

模型目錄

瀏覽模型可用性與功能。

定價

在呼叫模型之前先檢查定價。
Last modified on May 28, 2026