Saltar al contenido
FreshApp Demo

API ABIERTA

Genera desde tu propio código

Usa los modelos del sitio desde tu propio servidor. Crea una generación con una clave de API, síguela hasta que termine y descarga sus archivos.

Leer la documentación de la APIGestionar las claves de API

La API solo gasta créditos de pago: un paquete de créditos de pago o una suscripción de pago activa la habilita. Guarda tus claves en tu servidor.

SOLICITUD DE EJEMPLO

Crea tu primera generación

export API_ORIGIN='https://demo.freshapp.ai'
export API_KEY='sk_YOUR_API_KEY'

curl --fail-with-body "$API_ORIGIN/api/v1/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: order-1001' \
  -d '{"model":"seed-audio-1.0","input":{"prompt":"Un faro sobre un acantilado al amanecer, mar en calma, luz suave."}}'

# Read it every 5 to 10 seconds until its status ends.
curl --fail-with-body "$API_ORIGIN/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

# A delivered output's url is a signed link: no key needed.
curl --fail-with-body -o result "OUTPUT_URL"

Primero asigna tu clave a API_KEY. Envía una Idempotency-Key nueva con cada solicitud nueva, y la misma cuando vuelvas a enviar esa solicitud.

CÓMO FUNCIONA

Tres pasos de la solicitud al archivo

  1. Crea una generación

    Envía el id de un modelo y su entrada con tu clave de API y una Idempotency-Key. La respuesta es la generación, en cola, con los créditos que reserva.

  2. Síguela

    Consulta la generación cada 5 a 10 segundos hasta que termine bien, en parte, falle o se cancele. Lo que no usó vuelve al liquidarse.

  3. Descarga los archivos

    Cada salida entregada enlaza a su archivo en este sitio. Los enlaces que recibe una clave están firmados y se abren durante una hora sin la clave.

PERMISOS Y LÍMITES

Claves que solo hacen lo que permites

  • Una clave solo lee (lista, consulta y descarga) o también puede generar (crea y cancela), y una lista de IP permitidas puede atarla a tus servidores.

  • Una solicitud reserva como máximo 150 créditos, la solicitud más cara de los modelos activados; el ajuste de la clave o el max_credits de la solicitud solo pueden bajarlo.

  • Una clave gasta como máximo 5000 créditos por día UTC, y todas las claves de una cuenta juntas 10.000, salvo que fijes otros límites en la página de claves de API.

  • Por clave y por cuenta: 20 creaciones y cancelaciones y 240 consultas y descargas por minuto, y como máximo 2 generaciones en curso a la vez.

ARCHIVOS

El archivo OpenAPI y un cliente TypeScript

El archivo OpenAPI 3.1 describe cada operación, la entrada de cada modelo activado y cada código de error. El cliente TypeScript no necesita nada más: mantiene la misma Idempotency-Key en los reintentos y sigue una generación hasta el final, y el hook de React consulta con él.

Leer la documentación de la APIArchivo OpenAPI 3.1Cliente TypeScriptHook de React para seguimiento

PREGUNTAS FRECUENTES

Preguntas sobre la API