API de Seedance: Prompts y scripts en un solo endpoint

Prerrequisitos: Instala el SDK

Antes de enviar tu primera petición, asegúrate de tener instalado el SDK oficial de OpenAI para tu lenguaje preferido. Esta API utiliza el protocolo estándar chat/completions, por lo que cualquier cliente compatible con OpenAI funciona. Para Python, instala el paquete mediante pip. Para Node.js, usa npm. Solo necesitas la librería del cliente; no se requieren dependencias adicionales para la generación básica de texto o las llamadas a funciones.

Autenticación: Configura tu clave de API

La autenticación se maneja mediante un token Bearer simple. Crea una cuenta en la página Obtener clave de API para recibir tu clave única. No se requiere tarjeta de crédito para la prueba. Almacena esta clave en una variable de entorno o en el archivo de configuración de tu aplicación. La clave otorga acceso al modelo sin censura y está vinculada al saldo de tu crédito prepago. Regenera la clave en cualquier momento desde tu panel si es necesario.

Envío de una petición de completado de chat

Realiza una petición POST a la URL base. El campo model debe establecerse en uncensored. Incluye tu prompt del sistema para definir el rol y los mensajes del usuario para la generación de contenido. Este endpoint gestiona de manera eficiente tareas de guionización, generación de subtítulos y postprocesamiento de texto.

Copycurl https://api.seedanceapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Respuestas en streaming para salida en tiempo real

Para guiones largos o subtítulos en tiempo real, habilita el streaming estableciendo stream: true. La API devuelve un flujo de Eventos Enviados por el Servidor (SSE) de completados parciales. Esto permite que tu aplicación muestre el texto a medida que se genera, mejorando la latencia percibida. Maneja los fragmentos del flujo en tu SDK para actualizar la interfaz de usuario de forma incremental.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Uso de llamadas a funciones para datos estructurados

La API admite llamadas a funciones para extraer datos estructurados del texto o generar salida JSON. Define los esquemas de tus herramientas en la petición. El modelo responderá con argumentos estructurados que tu código puede ejecutar. Esto es ideal para pasos de postprocesamiento donde necesitas campos específicos de los guiones generados o metadatos.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.seedanceapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Comprensión de límites y cuotas

Observa los códigos de estado HTTP estándar. Un error 401 significa que tu clave de API no es válida o ha caducado. Un error 402 indica que tienes crédito prepago insuficiente; recarga para continuar. Un error 429 señala un límite de peticiones, limitado a 300 peticiones por minuto por clave. La ventana de contexto es de 100.000 tokens en total. Las peticiones que superen los 8 MB serán rechazadas.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.seedanceapis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);