Skip to main content
POST
/
api
/
partner
/
v1
/
slideshows
/
generate
Generate Slideshow
curl --request POST \
  --url https://api.example.com/api/partner/v1/slideshows/generate \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "product_id": {},
  "pack_id": {},
  "slide_count": 123,
  "slideshow_type": "<string>",
  "aspect_ratio": "<string>",
  "language": "<string>",
  "advanced_settings": {
    "font_size": "<string>",
    "text_preset": "<string>",
    "text_width": "<string>"
  },
  "skip_ai": true,
  "slide_config": {
    "total_slides": 123,
    "slide_types": [
      {}
    ],
    "custom_images": {},
    "pinned_images": {},
    "slide_texts": {},
    "slide_text_elements": {},
    "pack_assignments": {}
  }
}
'
Create a new slideshow in the authenticated key scope. generate supports:
  • AI generation from a prompt/product context
  • manual initial slide setup (skip_ai=true)
  • mixed setup with explicit slide_config

​
Body Parameters

​
prompt
string
Prompt used for AI text generation. Required unless skip_ai=true or product_id is provided.
​
product_id
string (UUID)
Optional product reference. Must exist in the authenticated key scope.
​
pack_id
string (UUID)
Optional global image pack ID. Required whenever any generated slide uses image_pack and no per-slide pack_assignments are provided.
​
slide_count
number
Optional target slide count (1-10). Default: 5.
​
slideshow_type
string
Optional: educational or personal. Default: educational.
​
aspect_ratio
string
Optional: 9:16, 1:1, or 4:5. Default: 4:5.
​
language
string
Optional language hint (2-32 chars).
​
advanced_settings
object
Optional text styling defaults.
​
skip_ai
boolean
Optional. When true, generation skips AI text creation and uses your slide_config input.
​
slide_config
object
Optional explicit per-slide setup.
All slide_config map keys must be 0-based numeric indices in range. image_pack slides must resolve a pack via pack_id or pack_assignments[index].

​
Examples

​
AI mode (prompt + global pack)

cURL
curl --request POST \
  --url https://www.genviral.io/api/partner/v1/slideshows/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "5 discipline quotes",
  "pack_id": "11111111-1111-1111-1111-111111111111",
  "slide_count": 1,
  "slideshow_type": "educational",
  "aspect_ratio": "4:5",
  "language": "en",
  "advanced_settings": {
    "font_size": "default",
    "text_preset": "tiktok",
    "text_width": "default"
  }
}'

​
Manual mode (skip_ai=true)

cURL
curl --request POST \
  --url https://www.genviral.io/api/partner/v1/slideshows/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "skip_ai": true,
  "slide_config": {
    "total_slides": 2,
    "slide_types": ["custom_image", "image_pack"],
    "custom_images": {
      "0": {
        "image_url": "https://cdn.example.com/custom-0.jpg",
        "image_id": "hero_0"
      }
    },
    "slide_text_elements": {
      "0": [
        {
          "content": "Hook text",
          "x": 50,
          "y": 25
        }
      ]
    },
    "pack_assignments": {
      "1": "11111111-1111-1111-1111-111111111111"
    }
  }
}'

​
Response

Returns 201 with the full slideshow object (same structure as Get Slideshow).
Response
{
  "ok": true,
  "code": 201,
  "message": "Slideshow generated",
  "data": {
    "id": "2ab58bb0-0c39-45c0-a4d5-b6852f9d7fc0",
    "title": "5 discipline quotes",
    "status": "draft",
    "slideshow_type": "educational",
    "product_id": null,
    "original_prompt": "5 discipline quotes",
    "preview_image_url": null,
    "created_at": "2026-02-14T09:20:00.000Z",
    "updated_at": "2026-02-14T09:20:00.000Z",
    "last_rendered_at": null,
    "slide_count": 1,
    "settings": {
      "image_pack_id": "11111111-1111-1111-1111-111111111111",
      "aspect_ratio": "4:5",
      "slideshow_type": "educational",
      "advanced_settings": {
        "font_size": "default",
        "text_preset": "tiktok",
        "text_width": "default"
      },
      "pack_assignments": null
    },
    "slides": [
      {
        "index": 0,
        "image_url": "https://cdn.example.com/slides/discipline-1.jpg",
        "rendered_image_url": null,
        "text_elements": [
          {
            "id": "9fd0b2bd-a95a-4488-8b7a-bf1d18d2bcdf",
            "content": "Discipline beats motivation",
            "x": 50,
            "y": 25,
            "font_size": 48,
            "width": 70,
            "height": null,
            "editable": true,
            "style_preset": "tiktok",
            "font_family": null,
            "background_color": null,
            "text_color": null,
            "border_radius": null
          }
        ],
        "grid_images": null,
        "grid_type": null,
        "background_filters": null,
        "image_overlays": null
      }
    ]
  }
}

​
Error Responses

  • 400 invalid_json - body is not valid JSON
  • 422 invalid_payload - schema/validation failed
  • 404 pack_not_found - referenced pack is missing or outside key scope
  • 422 pack_empty - selected pack has no images
  • 422 pack_required - one or more image_pack slides are missing pack resolution
  • 404 product_not_found - product_id does not exist
  • 403 forbidden_product_access - product_id exists but is outside key scope
  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 500 generate_failed - unexpected generation failure