Estimación del coste

Averigüe cuánto cuesta una generación en créditos sin ejecutar nada ni gastar créditos.

Playground

Authorization: Bearer <CLIPIA_API_KEY>

curl -X POST "https://api.clipia.ai/v1/models/nano-banana-2/estimate" \  -H "Content-Type: application/json" \  -d '{    "input": {      "prompt": "a sunset over mountains, cinematic",      "aspect_ratio": "16:9"    }  }'

{
  "credits": 40
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_api_key",
    "message": "API-ключ отсутствует, неверный или отозван."
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "not_found",
    "message": "Запрос с таким идентификатором не найден."
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "model_input_invalid",
    "message": "Параметр `resolution` не поддерживается этой моделью."
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after the reset window.",
    "retry_after_seconds": 12
  }
}

POST /v1/models/:model/estimate calcula el coste del input indicado en el modelo seleccionado. No se crea ningún trabajo ni se reservan créditos. Sirve cualquier clave válida: no se necesita ningún permiso adicional.

Solicitud

curl -X POST https://api.clipia.ai/v1/models/seedance-2-fast-i2v/estimate \
  -H "Authorization: Bearer $CLIPIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "prompt": "aerial shot over a neon city",
      "duration": 8,
      "resolution": "1080p"
    }
  }'

const { credits } = await clipia.models.estimate('seedance-2-fast-i2v', {
  prompt: 'aerial shot over a neon city',
  duration: 8,
  resolution: '1080p',
});
console.log(`This generation will cost ${credits} credits`);

estimate = client.models.estimate(
    "seedance-2-fast-i2v",
    {"prompt": "aerial shot over a neon city", "duration": 8, "resolution": "1080p"},
)
print(f"This generation will cost {estimate.credits} credits")

Respuesta 200

{
  "credits": 40
}

Si input contiene una clave que el modelo no aplicará (una errata, un parámetro de otro modelo), la estimación la enumera en warnings, con el mismo formato que el envío. Así puede comprobar un conjunto de parámetros antes de lanzar la generación.

Para qué usarlo

El coste depende del modelo y de sus parámetros —duración, resolución, número de imágenes, longitud del texto en la síntesis de voz—, no del tiempo que tarde realmente el trabajo. Por eso puede conocerlo de antemano:

• confirmar el precio antes de un vídeo caro en alta resolución;
• comparar opciones de parámetros, por ejemplo 4 frente a 8 segundos o 720p frente a 1080p;
• comprobar el presupuesto en flujos automatizados en los que un programa lanza la generación.

El envío usa el mismo cálculo: con los mismos parámetros, credits coincide con cost en la respuesta de POST /v1/models/{model}. Los créditos se reservan al enviar, se cobran si la generación tiene éxito y se reembolsan íntegramente si falla.

Errores