API per la generazione e modifica di immagini

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

Scegli un’API di immagini

Crea un'immagine

Genera immagini con una richiesta compatibile con OpenAI.

Crea una modifica dell'immagine

Modifica immagini con una richiesta compatibile con OpenAI.

Genera immagini con Gemini

Genera o modifica immagini con il formato Gemini.

Inizia con l'API Midjourney

Invia e interroga le attività di immagini Midjourney.

Genera un'immagine Flux

Genera immagini Flux tramite CometAPI.

Genera un'immagine Bria

Usa gli strumenti di generazione di immagini Bria.

Crea una prediction di Replicate

Esegui richieste di prediction di immagini nel formato Replicate.

Crea immagini Seedream

Crea richieste di generazione di immagini Seedream.

Genera un’immagine

Usa un model ID con capacità di immagini dalla pagina Models o dalla directory dei modelli. Gli esempi seguenti chiamano l’endpoint compatibile con OpenAI Create an image.

Questi esempi usano il segnaposto your-image-model-id. Sostituiscilo con un model ID di immagini disponibile dalla pagina Models o dalla directory dei modelli prima di eseguire la richiesta.

Apri Create an image 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())

const response = await fetch("https://api.cometapi.com/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "your-image-model-id",
    prompt: "A clean product photo of a glass teapot on a white table",
    size: "1024x1024",
  }),
});

if (!response.ok) {
  throw new Error(await response.text());
}

const result = await response.json();
console.log(Object.keys(result.data[0]));

curl https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-image-model-id",
    "prompt": "A clean product photo of a glass teapot on a white table",
    "size": "1024x1024"
  }'

Esempio di risposta

Una risposta riuscita può essere simile a questa. A seconda del modello 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 di modello

Questa risposta di esempio del catalogo modelli mostra l’envelope di /api/models e la struttura di un record di modello 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

Invalid model ID

Scegli un modello con supporto immagini dalla pagina Modelli.

Unsupported size

Usa una dimensione accettata dall’endpoint immagini selezionato.

Expired result URL

Scarica gli asset generati prima che i link del provider scadano.

Upload too large

Usa URL di immagini o file più piccoli invece di payload base64 di grandi dimensioni.

Missing image data

Controlla sia i campi b64_json sia url perché la struttura dell’output può variare in base al modello.

Codici di errore e strategia di retry

400

Non eseguire un retry finché il prompt, la dimensione o l’input immagine non sono stati corretti.

401

Non eseguire un retry finché la chiave API non è presente e valida.

404

Controlla base URL, path e model ID prima di eseguire un retry.

413

Riduci la dimensione dell’upload prima di eseguire un retry.

429

Esegui il retry con exponential backoff e riduci la concorrenza.

500 or 503

Esegui il retry 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.

Prezzi e directory dei modelli

Models page

Leggi come CometAPI espone i model ID nella documentazione.

Model directory

Esplora disponibilità e capacità dei modelli.

Pricing

Controlla i prezzi prima di chiamare un modello.

Moderazione dei contenuti

Chiavi API

API per la generazione e modifica di immagini

Scegli un’API di immagini

Crea un'immagine

Crea una modifica dell'immagine

Genera immagini con Gemini

Inizia con l'API Midjourney

Genera un'immagine Flux

Genera un'immagine Bria

Crea una prediction di Replicate

Crea immagini Seedream

Genera un’immagine

Esempio di risposta

Esempi di record di modello

Errori comuni

Codici di errore e strategia di retry

Prezzi e directory dei modelli

Models page

Model directory

Pricing

​Scegli un’API di immagini

Crea un'immagine

Crea una modifica dell'immagine

Genera immagini con Gemini

Inizia con l'API Midjourney

Genera un'immagine Flux

Genera un'immagine Bria

Crea una prediction di Replicate

Crea immagini Seedream

​Genera un’immagine

​Esempio di risposta

​Esempi di record di modello

​Errori comuni

​Codici di errore e strategia di retry

​Prezzi e directory dei modelli

Models page

Model directory

Pricing

Scegli un’API di immagini

Genera un’immagine

Esempio di risposta

Esempi di record di modello

Errori comuni

Codici di errore e strategia di retry

Prezzi e directory dei modelli