---
title: "Start Smart Virals Label"
method: POST
path: "/api/smart-virals/label"
tags: ["Smart Virals"]
---

# Start Smart Virals Label

`POST /api/smart-virals/label`

## Request

- Base URL: `https://api.premierecopilot.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.premierecopilot.com/api/smart-virals/label`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

Première passe de Smart Virals : labellise chaque phrase (hook,
développement, payoff, CTA, potentiel viral). Le résultat alimente l'écran
d'analyse, le constructeur manuel et POST /smart-virals (labeled_segments).

## Request body

- SmartViralsLabelRequest: Première passe : labellisation de chaque phrase (hook, développement, payoff, CTA, potentiel viral). Texte = audio envoyé ou mots du panneau.
  - `object_key` string, nullable
  - `transcription_words` object[], nullable
  - `sequence_structure` string
  - `prompt` string
  - `audio_duration_s` number, nullable

## Response `200`

Successful Response

- SmartViralsJobResponse
  - `job_id` string, required
  - `status` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-14** `a4e7c6afac52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/premierecopilot/apis/premierecopilot-api/changes/api/smart-virals/label/post.md)

---

[API](https://skmtc.dev/premierecopilot/apis/premierecopilot-api.md) - [All operations](https://skmtc.dev/premierecopilot/apis/premierecopilot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/premierecopilot/apis/premierecopilot-api/revisions/e3c26f9d5ae7?raw)
