The Hubfluencer API.

Create a Personal Access Token.

curl -X POST https://hubfluencer.com/api/tokens \
  -H "authorization: Bearer $SESSION_TOKEN" \
  -H "content-type: application/json" \
  -d '{"name":"Claude Code","scopes":["video:generate","video:read"]}'

201 Created
{
  "data": {
    "id": 42,
    "name": "Claude Code",
    "scopes": ["video:generate", "video:read"],
    "token": "hf_pat_9f3c…ONCE_ONLY",
    "inserted_at": "2026-06-03T10:00:00Z"
  }
}

List your tokens. A ["*"] scope listing means a full-access token.

200 OK
{
  "data": [
    { "id": 42, "name": "Claude Code",
      "scopes": ["video:generate","video:read"],
      "last_used_at": "2026-06-03T10:05:00Z",
      "inserted_at": "2026-06-03T10:00:00Z" }
  ]
}

Revoke a token. Returns 204 No Content.

Current credit balance. Check it before generating; a short costs 15 credits.

200 OK
{ "data": { "credits": 120 } }

Narration voices. Pass a voice id to generate-voice (editor ads). Shorts have no voice-over.

200 OK
{ "data": [
    { "id": "rachel", "name": "Rachel" },
    { "id": "adam",   "name": "Adam" }
] }

Create a short draft.

curl -X POST https://hubfluencer.com/api/shorts \
  -H "authorization: Bearer $HF" -H "content-type: application/json" \
  -d '{"product_prompt":"a 15s ad for my soy candle brand","language":"en","creative_format":"proof_demo","visual_language":"kinetic_creator"}'

201 Created
{
  "data": {
    "slug": "amber-candle-9x2",
    "stage": "draft",
    "language": "en",
    "latest_render": null,
    "inserted_at": "2026-06-03T10:00:00Z"
  }
}

Generate editable headline, subheadline, and caption beats from the saved short draft. No video credits are spent and no render starts.

curl -X POST https://hubfluencer.com/api/shorts/amber-candle-9x2/text/generate \
  -H "authorization: Bearer $HF"

Render the short. Idempotent per slug. Then poll GET /api/shorts/:slug.

curl -X POST https://hubfluencer.com/api/shorts/amber-candle-9x2/generate \
  -H "authorization: Bearer $HF" \
  -H "idempotency-key: gen-short:amber-candle-9x2"

Poll for status. stage is the signal: draft → rendering → video_ready (read latest_render.video_url) | failed (read failed_stage + error_message).

200 OK  — poll this until stage is video_ready or failed
{
  "data": {
    "slug": "amber-candle-9x2",
    "stage": "video_ready",
    "failed_stage": null,
    "error_message": null,
    "latest_render": {
      "status": "completed",
      "video_url": "https://…/amber-candle-9x2.mp4?X-Amz-Expires=86400"
    }
  }
}

Cost preflight — returns total and available_credits before you spend.

Create a carousel draft.

Render the carousel. Costs 1 credit per slide ⇒ 3–10 credits (default 5 slides = 5 credits). Send a fresh Idempotency-Key per attempt (a stable per-slug key replays the first response for 24h and blocks an intentional re-generate). The prompt is screened for content-policy compliance first — a violating prompt returns 422 prompt_rejected (code CONTENT_COMPLIANCE, with a category) and is not charged. Rate-limited to 10/min. Then poll GET /api/sliders/:slug until status is completed or failed.

Poll for status until terminal: draft → processing → completed (each slides[].image_url is a downloadable still; read caption + hashtags) | failed (read error_message; credits refunded). Each slides[] entry is { position, headline, body, kicker, status, image_url, background_url }; per-slide status is pending → processing → completed | failed (a not-yet-rendered slide is pending, not draft). image_url is the final composited slide (presigned, 24h TTL); background_url is the raw AI background preview (presigned, 1h TTL).

Edit one slide's on-image text: headline (≤120), body (≤600), kicker (≤40). Re-composites just that slide for free (reuses the AI background — no new image cost). The slider must already be completed (else 409 conflict); it runs async, flipping the slide back to processing — poll GET /api/sliders/:slug until it is completed again. Rate-limited to 20/min.

Restyle a completed carousel: body accepts template, accent_color (^#[0-9a-fA-F]{6}$), text_position (top/middle/bottom), and logo_s3_key — and re-composites EVERY slide for free (reuses the AI backgrounds). The slider must already be completed (else 409). Runs async (every slide → processing); poll GET /api/sliders/:slug until completed. Rate-limited to 20/min. (Confirming a logo via /logo/confirm on an already-completed carousel routes through restyle, so it likewise triggers a full re-composite of every slide, free.)

List your carousels (newest first). GET /api/sliders/:slug/cost returns total + available_credits. PATCH /api/sliders/:slug always edits the copy fields (caption, hashtags); the prompt and the render-shaping fields (language, mode, template, slide_count, aspect_ratio, accent_color, text_position, logo_s3_key) are editable here only while the slider is draft or failed (a failed render reopens them) — once processing/completed they are silently ignored (the prompt is locked post-generation; use restyle / the slide PATCH instead). DELETE /api/sliders/:slug removes a carousel and its images. POST /api/sliders/:slug/logo/presign then /logo/confirm attach an optional brand logo.

Create an editor project. Free accounts (0 credits) may hold up to 100 editor projects — a 101st returns 402 editor_factory_limit_reached; delete one or add credits. Accounts with credits are uncapped.

Run the full pipeline. Send an Idempotency-Key. Preflight the cost with GET /api/editor/:slug/autopilot/cost.

curl -X POST https://hubfluencer.com/api/editor \
  -H "authorization: Bearer $HF" -H "content-type: application/json" \
  -d '{"language":"en","product_prompt":"a cinematic ad for my candle brand","export_aspect_ratio":"9:16"}'
# then start autopilot:
curl -X POST https://hubfluencer.com/api/editor/$SLUG/autopilot \
  -H "authorization: Bearer $HF" -H "idempotency-key: autopilot:$SLUG"

200 OK  — poll this; autopilot embeds the finished MP4 in latest_render
{
  "data": {
    "slug": "candle-story-7k1",
    "autopilot_status": "completed",
    "autopilot_error_message": null,
    "scenario_prompt": "Warm, handcrafted… ",
    "segments_count": 5,
    "segments": [
      { "id": 81, "position": 1, "prompt": "Macro of wax pouring…", "status": "completed" },
      { "id": 82, "position": 2, "prompt": "Hands trimming the wick…", "status": "completed" }
    ],
    "narration_script": "Made by hand, poured in small batches…",
    "narration_status": "completed",
    "music": { "status": "completed" },
    "latest_render": {
      "status": "completed",
      "video_url": "https://…/candle-story-7k1.mp4?X-Amz-Expires=86400"
    }
  }
}

Get a presigned PUT URL for a video upload.

Returns 422 upload_quota_exceeded (with a quota object: limit/used/reserved/remaining bytes) if the upload would push your total live upload storage over the limit. Delete unused uploads to free space.

200 OK
{
  "data": {
    "upload_id": 510,
    "presigned_url": "https://r2…/editor/$SLUG/uploads/uuid.mp4?X-Amz-Signature=…",
    "s3_key": "editor/$SLUG/uploads/uuid.mp4",
    "expires_in_seconds": 3600
  }
}

Confirm the PUT. The server validates the object (Content-Type and size must match the presign) and queues processing.

List uploads with their processing status. Poll until status is "ready" before placing the clip.

200 OK  — status flows pending → processing → ready | failed
{
  "data": [
    { "id": 510, "filename": "clip.mp4", "mime_type": "video/mp4",
      "status": "ready", "duration_seconds": 6.2, "width": 1080, "height": 1920,
      "error_message": null, "attached_segment_ids": [83] }
  ]
}

Append a ready upload to the timeline as a finished scene. Body: upload_id. Rejects editor_upload_not_ready, batch_generation_active, autopilot_active (while Autopilot is running), editor_segment_limit (max 20 scenes).

Set one scene's video from an existing asset. Body: exactly one of upload_id or source_segment_id. Reuse a clip across scenes, or swap a generated scene for your footage.

Every render version with status and a presigned video_url. Use it to recover a finished URL or find a failed render to retry.

200 OK
{
  "data": [
    { "id": 9, "version": 2, "status": "completed",
      "video_url": "https://…/render.mp4?X-Amz-Expires=86400",
      "duration_seconds": 18.0, "error_message": null,
      "inserted_at": "2026-06-03T10:20:00Z" },
    { "id": 8, "version": 1, "status": "failed",
      "video_url": null, "error_message": "forge_timeout" }
  ]
}

Re-run a failed render from its saved snapshot. Only failed renders are retryable (editor_render_not_retryable otherwise).

The current quota.

200 OK
{
  "data": {
    "used": 4, "limit": 20, "bonus": 0, "remaining": 16,
    "resets_at": "2026-06-04T00:00:00Z",
    "unlock_cost": 1, "unlock_batch_size": 10
  }
}

Spend 1 credit for +10 assists. It's a repeatable purchase — do NOT send a stable Idempotency-Key (a reused key replays the first unlock for 24h, silently skipping later purchases).