> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.voicecheap.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter Detalhes do Projeto

> Recupere detalhes públicos do projeto, histórico de versões traduzidas e histórico de sincronização labial

# Obter Detalhes do Projeto

Recupere uma visualização pública normalizada de um projeto. Use este endpoint quando precisar do histórico de versões traduzidas, histórico de sincronização labial, estado dinâmico de legendas ou estado de publicação.

Para consultas frequentes, continue usando [Obter Status da Tradução](https://api-docs.voicecheap.ai/docs/pt/api-reference/translation-status.md). Este endpoint é mais rico e retorna intencionalmente mais dados.

## Solicitação

### Cabeçalhos

**x-api-key** `string` *required*

Sua chave de API VoiceCheap. Obtenha uma em [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).

### Parâmetros de Caminho

**projectId** `string` *required*

O identificador único do projeto retornado de [Criar Projeto](https://api-docs.voicecheap.ai/docs/pt/api-reference/create-project.md) ou [Iniciar Tradução](https://api-docs.voicecheap.ai/docs/pt/api-reference/translate.md).

## Resposta

**projectId** `string` *required*

O identificador único do projeto.

**projectName** `string` *required*

O nome do projeto.

**status** `string` *required*

Status público do projeto: `processing`, `success` ou `failed`.

**workflow** `string` *required*

Fluxo de trabalho da API: `translation` ou `transcription`. Os fluxos de trabalho de transcrição alcançam sucesso quando a transcrição da fonte é concluída.

**originalVideoUrl** `string` *required*

URL para o arquivo de vídeo ou áudio original enviado.

**originalLanguage** `string` *required*

O idioma original detectado ou especificado.

**targetLanguages** `string[]` *required*

Idiomas de destino associados ao projeto.

**duration** `number` *required*

Duração do conteúdo em segundos.

**createdAt** `number` *required*

Timestamp Unix de quando o projeto foi criado.

**progress** `object` *required*

Progresso atual no nível do projeto.

**propriedades de progresso**

**progress.step** `string`

Etapa atual de criação ou transcrição do projeto.

**progress.transcriptionProgress** `number`

Porcentagem aproximada de progresso da criação/transcrição do projeto.

**progress.transcriptionStatus** `string` *required*

Status da transcrição da fonte: `processing`, `success` ou `failed`.

**translations** `array` *required*

Histórico de versões traduzidas, ordenado com a versão mais recente primeiro.

**propriedades de tradução**

**translations\[].workId** `string`

Identificador do trabalho de tradução.

**translations\[].translatedVersionId** `string`

Identificador da versão traduzida.

**translations\[].targetLanguage** `string`

Idioma de destino para esta versão.

**translations\[].status** `string`

Status da versão de tradução: `in-progress`, `completed`, `not-started` ou `failed`.

**translations\[].currentStep** `string`

Etapa atual de dublagem para esta versão.

**translations\[].progress** `number`

Porcentagem aproximada de progresso da dublagem.

**translations\[].createdAt** `number`

Timestamp de quando esta versão traduzida foi criada.

**translations\[].completedAt** `number`

Timestamp de conclusão quando disponível.

**translations\[].failedAt** `number`

Timestamp de falha quando disponível.

**translations\[].timedOutAt** `number`

Timestamp de tempo limite quando disponível.

**translations\[].translatedVideoUrl** `string`

URL do vídeo traduzido.

**translations\[].translatedAudioUrl** `string`

URL do áudio traduzido.

**translations\[].settings** `object`

Configurações públicas usadas para a versão traduzida, como legendas, SmartSync, áudio de fundo e modo de qualidade.

**translations\[].settings.dubbingMode** `string`

`translate` quando a VoiceCheap traduziu a transcrição com o motor de tradução e o SmartSync, `dub-only` quando o texto veio de um `translatedSrt` que você enviou (veja [Dublar o projeto](https://api-docs.voicecheap.ai/docs/pt/api-reference/dub-project.md)). Versões só de dublagem informam sempre `smartSync: false`.

**translations\[].error** `object`

Código de erro e mensagem quando a versão traduzida falha.

**translations\[].lipSync** `object`

Histórico de sincronização labial para a versão traduzida, presente apenas quando a sincronização labial foi solicitada.

**Propriedades de sincronização labial**

**translations\[].lipSync.latest** `object`

Última tentativa de sincronização labial.

**translations\[].lipSync.history** `array`

Todas as tentativas de sincronização labial para esta versão traduzida, em ordem de criação.

**translations\[].lipSync.history\[].jobId** `string`

Identificador do trabalho de sincronização labial.

**translations\[].lipSync.history\[].status** `string`

Status da sincronização labial: `PENDING`, `PROCESSING`, `COMPLETED`, `FAILED`, `REJECTED` ou `CANCELED`.

**translations\[].lipSync.history\[].videoUrl** `string`

URL do vídeo com sincronização labial quando concluído.

**translations\[].lipSync.history\[].type** `string`

Modo de sincronização labial: `standard`, `pro` ou `studio`.

**translations\[].lipSync.history\[].activeSpeakerDetectionEnabled** `boolean`

Se a detecção de orador ativo foi habilitada para esta tentativa.

**translations\[].dynamicSubtitles** `object`

Estado das legendas dinâmicas quando disponível.

**translations\[].publicationAttempts** `array`

Estado da tentativa de publicação pública quando disponível.

**translations\[].publishedVideos** `array`

Referências de vídeo publicado publicamente quando disponível.

## Exemplo

```bash cURL theme={null}
curl -X GET "https://api.voicecheap.ai/v1/projects/abc123-def456-ghi789" \
  -H "x-api-key: vc_your-api-key"
```

```json Response theme={null}
{
  "projectId": "abc123-def456-ghi789",
  "projectName": "Launch Demo",
  "status": "success",
  "workflow": "translation",
  "originalVideoUrl": "https://storage.example.com/input.mp4",
  "originalLanguage": "en",
  "targetLanguages": ["french"],
  "duration": 120,
  "createdAt": 1791280000000,
  "progress": {
    "step": "done",
    "transcriptionProgress": 100,
    "transcriptionStatus": "success"
  },
  "translations": [
    {
      "workId": "work_123",
      "translatedVersionId": "version_456",
      "targetLanguage": "french",
      "status": "completed",
      "currentStep": "done",
      "progress": 100,
      "createdAt": 1791280200000,
      "completedAt": 1791280800000,
      "translatedVideoUrl": "https://storage.example.com/translated.mp4",
      "translatedAudioUrl": "https://storage.example.com/translated.mp3",
      "settings": {
        "voiceCloning": true,
        "uploadType": "video",
        "keepBackgroundMusic": true,
        "keepOriginalVoice": false,
        "originalVoiceVolume": 30,
        "subtitles": {
          "isEnable": true,
          "source": "translated"
        },
        "smartSync": true,
        "dubbingMode": "translate",
        "voiceIsolatorOption": "realistic",
        "translationQualityMode": "max"
      },
      "lipSync": {
        "latest": {
          "jobId": "lip_789",
          "status": "COMPLETED",
          "videoUrl": "https://storage.example.com/lipsync.mp4",
          "errorMessage": null,
          "type": "pro",
          "createdAt": "2026-06-08T10:00:00.000Z",
          "completedAt": "2026-06-08T10:20:00.000Z",
          "activeSpeakerDetectionEnabled": true
        },
        "history": [
          {
            "jobId": "lip_789",
            "status": "COMPLETED",
            "videoUrl": "https://storage.example.com/lipsync.mp4",
            "errorMessage": null,
            "type": "pro",
            "createdAt": "2026-06-08T10:00:00.000Z",
            "completedAt": "2026-06-08T10:20:00.000Z",
            "activeSpeakerDetectionEnabled": true
          }
        ]
      }
    }
  ]
}
```

## Erros

| Status | Código | Descrição |
| - | - | - |
| 401 | `MISSING_API_KEY` | A chave de API é necessária |
| 401 | `INVALID_API_KEY` | A chave de API fornecida é inválida |
| 403 | `FORBIDDEN` | Você não tem permissão para acessar o projeto |
| 404 | `PROJECT_NOT_FOUND` | O projeto não existe |
| 429 | `RATE_LIMIT_EXCEEDED` | Muitas solicitações |
| 500 | `INTERNAL_ERROR` | Erro inesperado do servidor |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.