API Reference
FreshOverview
Complete API reference for the Creatify AI video generation platform. All endpoints use the base URL https://api.creatify.ai and require X-API-ID and X-API-KEY authentication headers.
Endpoint Groups
Video Generation
| Group | Endpoints | Description |
|---|---|---|
| URL to Video | 7 endpoints | Convert webpage URLs into video ads |
| AI Avatar v1 | 5 endpoints | Single-scene avatar talking head videos |
| AI Avatar v2 | 5 endpoints | Multi-scene avatar videos |
| Aurora | 3 endpoints | SOTA studio-grade avatar from image |
| Product Video | 6 endpoints | Product image to video ad |
| AI Editing | 5 endpoints | AI-enhanced video editing |
| AI Shorts | 5 endpoints | Text to short-form video |
| Custom Templates | 7 endpoints | Branded template video generation |
Content and Assets
| Group | Endpoints | Description |
|---|---|---|
| Text to Speech | 3 endpoints | Text to AI voiceover |
| Text Generator | 4 endpoints | Gemini sync, async, and SSE text generation |
| AI Scripts | 3 endpoints | AI-generated video scripts |
| Asset Generator | 4 endpoints | 30+ AI image generation models |
| IAB Images | 3 endpoints | IAB-compliant ad banners |
Management
| Group | Endpoints | Description |
|---|---|---|
| Voices | 6 endpoints | List, clone, manage AI voices |
| Avatars | 5 endpoints | List and manage avatars/personas |
| Custom Avatars | 5 endpoints | Create and manage custom avatars |
| Links | 5 endpoints | Create and manage URL link objects |
| Workspace | 1 endpoint | Check remaining credits |
Discovery
| Group | Endpoints | Description |
|---|---|---|
| Inspiration | 5 endpoints | Browse pre-made video styles |
| Ad Clone | 3 endpoints | Clone existing ad creative styles |
| DYOA | 1 endpoint | Design Your Own Avatar listing |
| Music | 2 endpoints | Browse music categories and tracks |
Authentication
Every request requires these headers:
| Header | Required | Description |
|---|---|---|
| X-API-ID | Yes | Your API identifier |
| X-API-KEY | Yes | Your API secret key |
| Content-Type | For POST/PUT | application/json |
See Authentication SOP for setup details.
Common Response Pattern
All async video generation endpoints follow this pattern:
Create task:
- Request: POST with parameters
- Response:
Poll status:
- Request: GET /{id}/
- Response:
Status values: pending, processing, done, failed
See Status Codes Reference for full details.
See Also
- All Endpoints Table -- Every endpoint in one table
- Credit Costs -- Cost per endpoint
- Workflows -- End-to-end pipeline diagrams