Processamento em batch

<CodeBlock>```typescript
import { SyncClient } from "@sync.so/sdk";
const client = new SyncClient();
const batch = await client.batch.create(fs.createReadStream("input.jsonl"));
console.log('Batch created with ID:', batch.id)
```</CodeBlock>
<CodeBlock>```bash curl
curl -X POST https://api.sync.so/v2/batch \
     -H "x-api-key: <your-api-key>" \
     -H "Content-Type: multipart/form-data" \
     -F input=@<input.jsonl>
```</CodeBlock>
<CodeBlock>
```bash curl (JSON rows)
curl -X POST https://api.sync.so/v2/batch \
     -H "x-api-key: <your-api-key>" \
     -H "Content-Type: application/json" \
     -d '{
       "rows": [
         {"request_id": "request-1", "endpoint": "/v2/generate", "payload": {"model": "lipsync-2", "input": [{"type": "video", "url": "https://assets.sync.so/docs/example-video.mp4"}, {"type": "audio", "url": "https://assets.sync.so/docs/example-audio.wav"}]}},
         {"request_id": "request-2", "endpoint": "/v2/generate", "payload": {"model": "lipsync-2", "input": [{"type": "video", "url": "https://assets.sync.so/docs/example-video.mp4"}, {"type": "audio", "url": "https://assets.sync.so/docs/example-audio.wav"}]}}
       ],
       "dry_run": true
     }'
```</CodeBlock>
</CodeGroup>
Em vez de fazer upload de um arquivo, você pode enviar `application/json` com os registros em `rows`. Cada linha é o mesmo objeto que uma linha do JSONL, e as duas formas são validadas da mesma maneira: de 20 a 500 linhas por padrão, 5 MB ou menos quando escritas como JSONL e valores de `request_id` exclusivos. Quando um registro é recusado, o erro indica sua linha. As recusas de edição de diálogo a retornam no campo `lineNumber`; outros erros de registro, como JSON inválido ou `request_id` ausente, a indicam apenas em `message` (por exemplo `Record at line 4: payload is required`). As linhas contam registros não vazios, não linhas físicas, então linhas em branco em um arquivo JSONL são ignoradas; com um corpo JSON, a linha N é `rows[N-1]`. Os exemplos acima mostram dois registros para simplificar; um batch precisa de pelo menos 20.
**Parâmetros opcionais:** - `webhook_url`: Receba notificações quando o batch for concluído - `dry_run`: Defina como `true` para validar sua entrada sem processamento. Uma entrada válida retorna `{"status": "VALIDATED"}` e não cria nenhum batch.
A criação de batch não é coberta pelas [solicitações idempotentes](/api-reference/guides/idempotency). Se uma solicitação de criação atingir o tempo limite, liste seus batches com `GET /v2/batch` antes de enviar novamente, para não executar as mesmas linhas duas vezes.
</Step>
<Step title="Verifique o status do batch">
Monitore o progresso do seu batch pesquisando o status:
<CodeGroup>
<CodeBlock>```python Check batch status
batch = sync.batch.get(batch_id)
print(f"Status: {batch.status}")
print(f"Progress: {batch.metrics}")
```</CodeBlock>
<CodeBlock>```typescript
const batch = await client.batch.get(batch_id);
console.log('Status:', batch.status);
console.log('Progress:', batch.metrics);
```</CodeBlock>
<CodeBlock>```bash
curl https://api.sync.so/v2/batch/<batch_id> \
     -H "x-api-key: <your-api-key>"
```</CodeBlock>
</CodeGroup>
Um batch pode ter um dos seguintes status:
1. **`PENDING`**: Batch criado, aguardando início do processamento
2. **`PROCESSING`**: Gerações estão sendo processadas
3. **`COMPLETED`**: Todas as gerações finalizadas (com sucesso ou com falhas)
4. **`FAILED`**: O processamento em batch falhou totalmente
</Step>
<Step title="Verifique os resultados do batch">
Quando um batch é concluído, os resultados ficam disponíveis como um arquivo de linhas JSON no `outputUrl` da resposta de obtenção do batch. Um `GET` para esse URL retorna um redirecionamento `302` para um arquivo de resultado assinado; os clientes que seguem redirecionamentos automaticamente podem ler a resposta JSONL diretamente. Cada linha contém:
```jsonl output.jsonl
{"request_id": "request-1", "endpoint": "/v2/generate", "payload": {...}, "status": "COMPLETED", "error": null, "response": {...}, "updated_at": "2024-01-15T10:35:00Z"}
{"request_id": "request-2", "endpoint": "/v2/generate", "payload": {...}, "status": "FAILED", "error": {"code": "INVALID_INPUT", "message": "..."}, "response": null, "updated_at": "2024-01-15T10:35:00Z"}