API Overzicht
Welkom bij de officiële documentatie van de Viral Growth API. Gebruik deze documentatie om sneller te integreren met onze neurale netwerk videorendering clusters.
curl -X POST https://api.nl.viral-growth.top/v1/video/generate \
-H "Authorization: Bearer sk-live-***" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Virale video over tech",
"duration_seconds": 15,
"voice_id": "nl-amsterdam-1"
}'
Extensieve Endpoints (V1)
Hieronder vindt u de basis endpoint mapping. Gebruik Bearer tokens voor veilige toegang over HTTPS.
- POST
/v1/video/generate - Genereer een nieuwe AI video
- GET
/v1/video/status/{id} - Controleer render-status
- POST
/v1/audio/tts/dutch - Neurale tekst-naar-spraak (NL)
- POST
/v1/campaigns/create - Maak een virale campagne aan
- GET
/v1/analytics/engagement - Haal real-time statistieken op
- GET
/v1/models/list - Bekijk beschikbare AI modellen
- POST
/v1/webhooks/register - Registreer callbacks
- POST
/v1/library/assets - Upload mediabestanden
- GET
/v1/account/quota - Bekijk uw limieten
- POST
/v1/auth/token/refresh - Vernieuw API token
Video: Genereer
Plaats een render-taak in de wachtrij met de POST /v1/video/generate endpoint. U ontvangt een Task-ID om asynchroon de status op te vragen.
// Payload
{
"prompt": "Nederlandse startup pitch",
"resolution": "1080x1920",
"voice_id": "nl-amsterdam-2"
}
// Response format
{ "task_id": "vid_8x3jd92k", "status": "processing" }
Video: Check Status
Haal de actuele status en URL van de gegenereerde video op met GET /v1/video/status/{task_id}.
// Response format (200 OK)
{
"task_id": "vid_8x3jd92k",
"status": "completed",
"url": "https://cdn.nl.viral-growth.top/assets/vid_8x3jd92k.mp4",
"render_time_ms": 1450
}
Audio: Dutch TTS
Endpoint: POST /v1/audio/tts/dutch. Genereer natuurlijke, gelokaliseerde voice-overs.
// Payload
{ "text": "Welkom bij onze nieuwe SaaS tool", "dialect": "amsterdam" }
// Response format
{ "audio_url": "https://cdn.nl.viral-growth.top/tts/audio_5.mp3", "duration": 2.4 }
Campagnes: Beheer
Endpoint: POST /v1/campaigns/create. Maak logische groepen voor uw A/B testen.
// Payload
{ "name": "Zomer Uitverkoop 2026", "budget_limit": 500 }
// Response format
{ "campaign_id": "camp_992", "status": "active" }
Analytics: Real-time
Endpoint: GET /v1/analytics/engagement. Monitor impressies en CTR van de web-player.
// Response format
{ "views": 14500, "clicks": 320, "ctr": 0.022 }
Systeem: Webhooks
Endpoint: POST /v1/webhooks/register. Stel webhook URL's in om asynchrone push-events te ontvangen.
// Payload
{ "events": ["video.completed", "video.failed"], "url": "https://uw-app.nl/webhook" }
// Response format
{ "webhook_id": "wh_82h", "secret": "sec_***" }
Systeem: Asset Library
Endpoint: POST /v1/library/assets. Upload B-roll en statische merk-assets via multipart/form-data.
// Form Data
file=@logo.png
type="watermark"
// Response format
{ "asset_id": "ast_9912", "url": "https://cdn.nl.viral-growth.top/ast_9912.png" }
Systeem: Account Quota
Endpoint: GET /v1/account/quota. Vraag uw API en GPU usage op.
// Response format
{ "tier": "Enterprise", "gpu_minutes_used": 1500, "remaining": 8500 }