API Seedance: Prompts e scripts por um único endpoint

Pré-requisitos: Instale o SDK

Antes de enviar sua primeira requisição, certifique-se de ter o SDK oficial da OpenAI para sua linguagem preferida instalado. Esta API usa o protocolo padrão chat/completions, então qualquer cliente compatível com OpenAI funciona. Para Python, instale o pacote via pip. Para Node.js, use npm. Você só precisa da biblioteca cliente; não são necessárias dependências extras para geração de texto básica ou chamada de funções.

Autenticação: Configurando sua chave de API

A autenticação é feita via token Bearer simples. Crie uma conta na página Obter chave de API para receber sua chave exclusiva. Não é necessário cartão de crédito para o teste. Armazene esta chave em uma variável de ambiente ou no arquivo de configuração do seu aplicativo. A chave concede acesso ao modelo sem censura e está vinculada ao seu saldo de crédito pré-pago. Regere a chave a qualquer momento no seu painel, se necessário.

Enviando uma solicitação de conclusão de chat

Faça uma requisição POST para a URL base. O campo model deve ser definido como uncensored. Inclua seu prompt de sistema para definir o papel e mensagens do usuário para a geração de conteúdo. Este endpoint lida com roteirização, legendagem e tarefas de pós-processamento de texto de forma eficiente.

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."}]
  }'

Respostas em streaming para saída em tempo real

Para roteiros longos ou legendagem em tempo real, ative o streaming definindo stream: true. A API retorna um stream de Eventos Enviados pelo Servidor (SSE) de conclusões parciais. Isso permite que seu aplicativo exiba o texto à medida que é gerado, melhorando a latência percebida. Processe os chunks do stream no seu SDK para atualizar a interface do usuário incrementalmente.

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)

Usando chamada de funções para dados estruturados

A API suporta chamada de funções para extrair dados estruturados do texto ou gerar saída JSON. Defina os esquemas de suas ferramentas na solicitação. O modelo responderá com argumentos estruturados que seu código pode executar. Isso é ideal para etapas de pós-processamento onde você precisa de campos específicos de scripts gerados ou metadados.

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)

Entendendo limites e cotas

Observe os códigos de status HTTP padrão. Um erro 401 significa que sua chave de API é inválida ou expirou. Um erro 402 indica crédito pré-pago insuficiente; recarregue para continuar. Um erro 429 sinaliza limite de requisições, limitado a 300 requisições por minuto por chave. A janela de contexto é de 100.000 tokens no total. Requisições que excedam 8 MB serão rejeitadas.

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);