> ## 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.

# Pubblica il video originale

> Pubblica o programma i contenuti multimediali originali del progetto sui tuoi canali YouTube/TikTok connessi, facoltativamente con sottotitoli dinamici. L'operazione pubblica su piattaforme esterne; scegli esplicitamente la privacy quando desideri l'accesso pubblico.

Pubblica o programma i contenuti multimediali originali del progetto sui tuoi canali YouTube/TikTok connessi, facoltativamente con sottotitoli dinamici. L'operazione pubblica su piattaforme esterne; scegli esplicitamente la privacy quando desideri l'accesso pubblico.

```http theme={null}
POST https://api.voicecheap.ai/v1/actions/publishing_original_create
```

## Autenticazione e autorizzazioni

<ParamField header="x-api-key" type="string" required>
  Invia una chiave API VoiceCheap in questa intestazione. È supportato anche Authorization: Bearer con la stessa chiave API. I token di accesso OAuth
  sono accettati solo da MCP, non da questo endpoint REST.
</ParamField>

Autorizzazioni richieste: `publishing:write`, `projects:read`.

È necessario un abbonamento a pagamento attivo. Le autorizzazioni non modificano i ruoli del team, la proprietà delle risorse, i crediti multimediali o i limiti del piano.

## Parametri

<ParamField body="projectId" type="string" required>
  Valore testuale.

  Lunghezza minima: 1. Lunghezza massima: 200. Pattern: `^[^/\\]+$`.
</ParamField>

<ParamField body="workId" type="string" required>
  Valore testuale.

  Lunghezza minima: 1. Lunghezza massima: 200. Pattern: `^[^/\\]+$`.
</ParamField>

<ParamField body="title" type="string" required>
  Valore testuale.

  Lunghezza minima: 1. Lunghezza massima: 100.
</ParamField>

<ParamField body="description" type="string">
  Valore testuale.

  Lunghezza massima: 5000.
</ParamField>

<ParamField body="youtubeChannelIds" type="array">
  Elenco di valori. Consulta lo schema di input completo per la struttura degli elementi.

  Numero massimo di elementi: 20.
</ParamField>

<ParamField body="tiktokChannelIds" type="array">
  Elenco di valori. Consulta lo schema di input completo per la struttura degli elementi.

  Numero massimo di elementi: 20.
</ParamField>

<ParamField body="youtubePrivacyStatus" type="string">
  Valore testuale.

  Valori consentiti: "public", "unlisted", "private". Valore predefinito: "private".
</ParamField>

<ParamField body="tiktokPrivacyLevel" type="string">
  Valore testuale.

  Valori consentiti: "PUBLIC\_TO\_EVERYONE", "MUTUAL\_FOLLOW\_FRIENDS", "FOLLOWER\_OF\_CREATOR", "SELF\_ONLY". Valore predefinito: "SELF\_ONLY".
</ParamField>

<ParamField body="includeDynamicSubtitles" type="boolean">
  Valore booleano.

  Valore predefinito: false.
</ParamField>

<ParamField body="scheduledAt" type="string">
  Valore testuale.

  Formato: "date-time". Pattern: `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$`.
</ParamField>

<ParamField body="requestId" type="string">
  Facoltativo al livello di trasporto: se omesso, il server inserisce un identificatore prima della validazione. Fornisci un tuo UUID v4 stabile per recuperare in sicurezza una risposta persa.

  Formato: "uuid". Pattern: `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$`.
</ParamField>

<Accordion title="Schema di input completo">
  Il JSON Schema seguente conserva i nomi esatti dei campi, i tipi annidati, i valori predefiniti, i limiti e i valori accettati esposti dalla discovery. Le ulteriori regole tra campi sono elencate nelle note sull'operazione.

  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "projectId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200,
        "pattern": "^[^/\\\\]+$"
      },
      "workId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200,
        "pattern": "^[^/\\\\]+$"
      },
      "title": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      },
      "description": {
        "type": "string",
        "maxLength": 5000
      },
      "youtubeChannelIds": {
        "maxItems": 20,
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "pattern": "^[^/\\\\]+$"
        }
      },
      "tiktokChannelIds": {
        "maxItems": 20,
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "pattern": "^[^/\\\\]+$"
        }
      },
      "youtubePrivacyStatus": {
        "default": "private",
        "type": "string",
        "enum": ["public", "unlisted", "private"]
      },
      "tiktokPrivacyLevel": {
        "default": "SELF_ONLY",
        "type": "string",
        "enum": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "FOLLOWER_OF_CREATOR", "SELF_ONLY"]
      },
      "includeDynamicSubtitles": {
        "default": false,
        "type": "boolean"
      },
      "scheduledAt": {
        "type": "string",
        "format": "date-time",
        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
      },
      "requestId": {
        "type": "string",
        "format": "uuid",
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
        "description": "UUID v4 for this action. Reuse the same ID with identical arguments on retries."
      }
    },
    "required": ["projectId", "workId", "title"],
    "additionalProperties": false
  }
  ```
</Accordion>

## Idempotenza

Usa un UUID v4 in requestId o nell'intestazione HTTP Idempotency-Key per ogni modifica. Riutilizza lo stesso identificatore e argomenti identici dopo un errore di rete. Se vengono forniti entrambi, devono coincidere. Ripetere una richiesta salvata non ripete l'operazione e non consuma un'altra chiamata mensile. Le richieste non riuscite o interrotte non vengono riavviate automaticamente.

Ogni modifica può restituire HTTP 202 quando un nuovo tentativo trova la stessa richiesta ancora in esecuzione, anche se la prima esecuzione è normalmente sincrona. Se l'esecuzione è completata ma resultStored è false, un nuovo tentativo restituisce HTTP 200 con lo stato della richiesta salvata anziché il risultato originale. Recupera l'output tramite l'azione di cronologia, risultato o download del relativo dominio.

## Esempi di richiesta

Sostituisci gli identificatori delle risorse e le chiavi multimediali di esempio con i valori restituiti per il tuo account. Mantieni stabile l'identificatore della richiesta quando ripeti la stessa modifica.

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST 'https://api.voicecheap.ai/v1/actions/publishing_original_create' \
    --header "x-api-key: $VOICECHEAP_API_KEY" \
    --header 'Content-Type: application/json' \
    --data '{"projectId":"project_launch_2026","workId":"5f8423d1-e4c0-4f80-9e3f-eed959389e24","title":"Product launch","description":"Meet the new product.","youtubeChannelIds":["UC1234567890abcdefghijkl"],"youtubePrivacyStatus":"private","includeDynamicSubtitles":false,"requestId":"41321bda-e243-4b6f-96a4-622cd047c991"}'
  ```

  ```javascript JavaScript theme={null}
  const input = {
    projectId: 'project_launch_2026',
    workId: '5f8423d1-e4c0-4f80-9e3f-eed959389e24',
    title: 'Product launch',
    description: 'Meet the new product.',
    youtubeChannelIds: ['UC1234567890abcdefghijkl'],
    youtubePrivacyStatus: 'private',
    includeDynamicSubtitles: false,
    requestId: '41321bda-e243-4b6f-96a4-622cd047c991',
  };
  const response = await fetch('https://api.voicecheap.ai/v1/actions/publishing_original_create', {
    method: 'POST',
    headers: {
      'x-api-key': process.env.VOICECHEAP_API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(input),
  });
  const body = await response.json();
  if (!response.ok) throw new Error(body.code + ': ' + body.message);
  console.log(body);
  ```

  ```python Python theme={null}
  import os
  import requests

  response = requests.post(
      "https://api.voicecheap.ai/v1/actions/publishing_original_create",
      headers={"x-api-key": os.environ["VOICECHEAP_API_KEY"]},
      json={"projectId": "project_launch_2026", "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24", "title": "Product launch", "description": "Meet the new product.", "youtubeChannelIds": ["UC1234567890abcdefghijkl"], "youtubePrivacyStatus": "private", "includeDynamicSubtitles": False, "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"},
      timeout=120,
  )
  body = response.json()
  if not response.ok:
      raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
  print(body)
  ```
</RequestExample>

## Risposta

Questa operazione restituisce HTTP 202 mentre è in esecuzione. Salva requestId e interroga action\_request\_get con questo identificatore e il nome dell'operazione originale. Gli stati del polling sono running, completed, failed e interrupted. Un risultato completato può rimandare a un processo multimediale separato; prosegui con l'azione di stato o di output specifica dell'operazione.

Restituisce lo stato pubblico aggiornato della pubblicazione originale dopo aver richiesto la pubblicazione o la programmazione sui canali selezionati.

<ResponseExample>
  ```json HTTP 202 theme={null}
  {
    "data": {
      "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
      "status": "running",
      "pollAction": "action_request_get",
      "pollAfterSeconds": 5
    },
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
  }
  ```

  ```json HTTP 200 theme={null}
  {
    "data": {
      "projectId": "project_launch_2026",
      "originalPublish": {
        "id": "7db6b953-7664-4bc2-811a-6aa7aa29038d",
        "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24",
        "title": "Product launch",
        "description": "Meet the new product.",
        "status": "completed",
        "useDynamicSubtitles": false,
        "createdAt": 1792152000000,
        "updatedAt": 1792152060000,
        "channels": [
          {
            "channelId": "UC1234567890abcdefghijkl",
            "platform": "youtube",
            "status": "completed",
            "videoId": "example1234",
            "videoUrl": "https://www.youtube.com/watch?v=example1234"
          }
        ]
      }
    },
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
  }
  ```

  ```json HTTP 202 replay_running theme={null}
  {
    "data": {
      "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
      "operation": "publishing_original_create",
      "createdAt": 1792144800000,
      "updatedAt": 1792144820000,
      "status": "running",
      "pollAfterSeconds": 5
    },
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
  }
  ```

  ```json HTTP 200 replay_completed_without_result theme={null}
  {
    "data": {
      "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
      "operation": "publishing_original_create",
      "createdAt": 1792144800000,
      "updatedAt": 1792144820000,
      "status": "completed",
      "resultStored": false,
      "message": "The action completed. Retrieve its output from the corresponding history or resource action."
    },
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991"
  }
  ```
</ResponseExample>

## Campi del risultato

| Campo | Descrizione |
| - | - |
| `data.projectId` | Identificatore del progetto padre. |
| `data.originalPublish` | Stato pubblico aggiornato della pubblicazione dell'originale, oppure null. |
| `data.originalPublish.id` | Identificatore del tentativo di pubblicazione dell'originale. |
| `data.originalPublish.workId` | Identificatore opzionale del lavoro linguistico usato dal flusso di pubblicazione originale. |
| `data.originalPublish.title` | Titolo della pubblicazione. |
| `data.originalPublish.description` | Descrizione opzionale. |
| `data.originalPublish.status` | idle, scheduled, in-progress, completed o failed. |
| `data.originalPublish.useDynamicSubtitles` | Indica se il flusso di pubblicazione originale richiedeva sottotitoli dinamici. |
| `data.originalPublish.dynamicSubtitlesVideoUrl` | URL facoltativo del video generato con sottotitoli. |
| `data.originalPublish.scheduledAt` | Ora programmata opzionale in millisecondi Unix. |
| `data.originalPublish.createdAt` | Ora di creazione in millisecondi Unix. |
| `data.originalPublish.updatedAt` | Ora dell'ultimo aggiornamento in millisecondi Unix. |
| `data.originalPublish.channels` | Stato per canale con channelId, platform, status e i campi facoltativi videoId, videoUrl, scheduledAt. |

## Recupera e monitora questa richiesta

Usa lo stesso identificatore anche dopo una connessione persa. Se resultStored è false, recupera l'output tramite la corrispondente azione di cronologia, risultato o download. Non avviare mai una seconda generazione solo per verificarne l'avanzamento.

```bash theme={null}
curl --request POST 'https://api.voicecheap.ai/v1/actions/action_request_get' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"requestId":"41321bda-e243-4b6f-96a4-622cd047c991","operation":"publishing_original_create"}'
```

```json HTTP 200 theme={null}
{
  "data": {
    "requestId": "41321bda-e243-4b6f-96a4-622cd047c991",
    "operation": "publishing_original_create",
    "status": "completed",
    "createdAt": 1792144800000,
    "updatedAt": 1792144820000,
    "resultStored": true,
    "result": {
      "projectId": "project_launch_2026",
      "originalPublish": {
        "id": "7db6b953-7664-4bc2-811a-6aa7aa29038d",
        "workId": "5f8423d1-e4c0-4f80-9e3f-eed959389e24",
        "title": "Product launch",
        "description": "Meet the new product.",
        "status": "completed",
        "useDynamicSubtitles": false,
        "createdAt": 1792152000000,
        "updatedAt": 1792152060000,
        "channels": [
          {
            "channelId": "UC1234567890abcdefghijkl",
            "platform": "youtube",
            "status": "completed",
            "videoId": "example1234",
            "videoUrl": "https://www.youtube.com/watch?v=example1234"
          }
        ]
      }
    }
  }
}
```

## Note sull'operazione

* Questa azione pubblica all'esterno e richiede la proprietà del progetto. Almeno uno degli array youtubeChannelIds o tiktokChannelIds deve contenere un canale collegato all'attore autenticato; ogni array consente al massimo 20 voci.
* workId deve appartenere a questo progetto anche se il contenuto multimediale selezionato è il video originale.
* L'integrazione usa per impostazione predefinita youtubePrivacyStatus private e tiktokPrivacyLevel SELF\_ONLY. Imposta esplicitamente la privacy desiderata quando intendi consentire un accesso più ampio.
* includeDynamicSubtitles è false per impostazione predefinita e richiede subtitles:write quando abilitato. Usa le normali quote dei sottotitoli e i crediti multimediali.
* scheduledAt è una data e ora ISO facoltativa con offset. Solo un orario strettamente futuro programma il flusso di lavoro dell'originale; un timestamp passato valido non lo programma e può provocare la pubblicazione immediata.
* Questa è un'azione di lunga durata. Interroga periodicamente action\_request\_get per il completamento del gestore, quindi publishing\_list per l'avanzamento della pubblicazione della risorsa o i risultati programmati.
* originalPublish può essere null quando non è disponibile alcuno stato, oppure mostrare lo stato in-progress, scheduled, completed o failed. Gli esiti dei singoli canali si trovano in channels, quindi un risultato restituito non garantisce la pubblicazione riuscita su ogni canale.

## Utilizzo

Ogni invocazione riuscita consuma una chiamata API/MCP mensile. Si applicano anche i crediti multimediali e le quote di generazione proprie dell'operazione.

## Errori

| Stato HTTP | Codice | Significato o risoluzione |
| - | - | - |
| 400 | `BAD_REQUEST` | Il contenuto multimediale originale non è disponibile, è attiva un'altra pubblicazione dell'originale oppure i dati di pubblicazione non sono validi. |
| 400 | `CREDENTIAL_IN_QUERY` | Le credenziali sono state fornite in un parametro di query access\_token o api\_key. Invia le credenziali negli header. |
| 400 | `IDEMPOTENCY_CONFLICT` | L'intestazione Idempotency-Key e il campo requestId del corpo devono coincidere. |
| 400 | `INVALID_REQUEST_ID` | Fornisci requestId o Idempotency-Key come UUID v4. |
| 400 | `VALIDATION_ERROR` | Correggi l'input usando lo schema. I valori non validi o incoerenti vengono rifiutati prima dell'esecuzione. |
| 401 | `API_KEY_EXPIRED` | La chiave API è scaduta. |
| 401 | `INVALID_API_KEY` | Fornisci una chiave API valida e non scaduta. |
| 401 | `INVALID_CREDENTIAL` | L'header Authorization non è valido oppure è in conflitto con x-api-key. |
| 401 | `MISSING_CREDENTIAL` | Non è stata fornita alcuna credenziale utilizzabile negli header, oppure la credenziale superava 4096 caratteri. |
| 401 | `USER_NOT_FOUND` | L'account associato alla credenziale non esiste più. |
| 403 | `ACCOUNT_UNAVAILABLE` | L'account che esegue l'azione o quello di fatturazione non è disponibile o è in fase di eliminazione. |
| 403 | `AMBIGUOUS_TEAM_API_KEY` | L'utente della credenziale appartiene a più di un team, quindi il contesto di fatturazione è ambiguo. |
| 403 | `FORBIDDEN` | L'utente chiamante autenticato non può accedere a questo progetto. |
| 403 | `INSUFFICIENT_SCOPE` | includeDynamicSubtitles true richiede anche subtitles:write. |
| 403 | `INTEGRATION_PLAN_UNSUPPORTED` | Impossibile verificare i limiti di integrazione dell'account. |
| 403 | `OWNER_REQUIRED` | Solo il proprietario del progetto può pubblicare i contenuti multimediali originali del progetto. |
| 403 | `PUBLISHING_CHANNEL_FORBIDDEN` | Ogni canale selezionato deve appartenere al chiamante autenticato. |
| 403 | `SUBSCRIPTION_REQUIRED` | Usa un abbonamento a pagamento attivo. |
| 403 | `TEAM_OWNER_NOT_FOUND` | Non è stato possibile trovare l'account effettivo del proprietario del team. |
| 404 | `PROJECT_NOT_FOUND` | Il progetto non esiste nell'account accessibile. |
| 404 | `TRANSLATION_NOT_FOUND` | workId non identifica un lavoro linguistico appartenente a questo progetto. |
| 409 | `CONCURRENT_ACTION_LIMIT_REACHED` | Questo account ha già 10 azioni di integrazione in esecuzione. Interroga una richiesta esistente prima di avviarne un'altra. |
| 409 | `IDEMPOTENCY_CONFLICT` | Riutilizza un identificatore solo con la stessa operazione e gli stessi argomenti. |
| 429 | `INTEGRATION_MONTHLY_LIMIT_REACHED` | Attendi il ripristino mensile o cambia piano. |
| 429 | `INTEGRATION_RATE_LIMIT_REACHED` | Rispetta Retry-After quando presente e applica attese crescenti tra i tentativi. |
| 500 | `INTERNAL_ERROR` | Controlla lo stato della richiesta salvata e la cronologia delle risorse prima di decidere se ripetere una modifica. |
| 503 | `ACTION_RESULT_UNAVAILABLE` | L'azione è stata eseguita ma non è stato possibile salvarne il risultato. Esamina lo stato della richiesta salvata e la cronologia delle risorse prima di avviare una nuova generazione. |
| 503 | `SERVER_RESTARTING` | Il server si sta riavviando. Riprova tra poco e mantieni lo stesso identificatore della richiesta per una modifica. |

```json theme={null}
{
  "code": "INSUFFICIENT_SCOPE",
  "message": "This credential does not permit the requested action.",
  "status": 403,
  "details": {
    "requiredScopes": ["publishing:write", "projects:read"]
  }
}
```


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