Vai al contenuto principale

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.

Usa la documentazione dei modelli immagine di CometAPI scegliendo il formato della richiesta che corrisponde al tuo flusso di lavoro. Gli endpoint immagini compatibili con OpenAI coprono i flussi comuni di generazione e modifica; le pagine specifiche dei provider coprono sistemi di immagini basati su attività.

Scegli un’API immagine

Image Generations

Genera immagini con una richiesta compatibile con OpenAI.

Image Editing

Modifica immagini con una richiesta compatibile con OpenAI.

Gemini image generation

Genera o modifica immagini con il formato Gemini.

Midjourney quick start

Invia e interroga le attività immagine di Midjourney.

Flux Generate Image

Genera immagini Flux tramite CometAPI.

Bria Generate Image

Usa gli strumenti di generazione immagini di Bria.

Genera un’immagine

Usa un model ID con capacità immagine dalla Models page o dalla model directory. Gli esempi seguenti chiamano la Image Generations API compatibile con OpenAI.
Questi esempi usano il segnaposto your-image-model-id. Sostituiscilo con un model ID immagine disponibile dalla Models page o dalla model directory prima di eseguire la richiesta.
Apri Image Generations per usare il playground e lo schema dell’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())

Esempio di risposta

Una risposta riuscita può apparire così. A seconda del model selezionato, ogni elemento può contenere un’immagine base64 o un URL del risultato:
{
  "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
  }
}

Esempi di record dei modelli

Questa risposta di esempio del catalogo dei modelli mostra l’envelope /api/models e la struttura di un record di model immagine. Non è un elenco completo dei modelli.
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
      }
    }
  ]
}

Errori comuni

Scegli un model con capacità immagine dalla Models page.
Usa una size accettata dall’endpoint immagine selezionato.
Scarica gli asset generati prima che i link del provider scadano.
Usa URL delle immagini o file più piccoli invece di payload base64 di grandi dimensioni.
Controlla entrambi i campi b64_json e url perché la struttura dell’output può variare in base al model.

Codici di errore e strategia di retry

Non riprovare finché il prompt, la size o l’input immagine non sono corretti.
Non riprovare finché l’API key non è presente e valida.
Controlla il base URL, il path e il model ID prima di riprovare.
Riduci la dimensione dell’upload prima di riprovare.
Riprova con backoff esponenziale e riduci la concorrenza.
Riprova con backoff per errori transitori del provider o del servizio.
Per i pattern di implementazione, vedi Error codes and retry strategy e Rate limits and concurrency.

Pricing e directory dei modelli

Models page

Leggi come CometAPI espone i model ID nella documentazione.

Model directory

Esplora disponibilità e funzionalità dei modelli.

Pricing

Controlla i prezzi prima di chiamare un model.
Last modified on May 28, 2026