Automate Content with n8n (Legacy API)

Note: The Hedra v3 API is now available. This guide covers the legacy API and is maintained for existing integrations. For new projects, get started with the Developer Platform →

n8n is a workflow automation tool that lets you connect APIs visually. This guide shows how to use n8n’s HTTP Request node to automate content generation with the Hedra API.

Authentication setup

Before building workflows, create a reusable credential for the Hedra API:

Go to Credentials in n8n
Click Add Credential → Header Auth
Set Name to X-API-Key and Value to your Hedra API key
Save as “Hedra API Key”

Use this credential in every HTTP Request node by selecting Authentication → Generic Credential Type → Header Auth → Hedra API Key.

Example: Generate an image on a schedule

This workflow generates a daily image from a prompt.

Node 1: Schedule Trigger

Type: Schedule Trigger
Interval: Every day at 9:00 AM

Node 2: Generate Image

Type: HTTP Request
Method: POST
URL: https://api.hedra.com/web-app/public/generations
Authentication: Header Auth → Hedra API Key
Body (JSON):

{
  "type": "image",
  "text_prompt": "A vibrant abstract background for social media",
  "model_slug": "google/nano-banana-pro",
  "aspect_ratio": "1:1",
  "resolution": "2K"
}

Node 3: Wait

Type: Wait
Duration: 30 seconds

Node 4: Check Status

Type: HTTP Request
Method: GET
URL: https://api.hedra.com/web-app/public/generations/{{ $('Generate Image').item.json.id }}/status
Authentication: Header Auth → Hedra API Key

Node 5: Check if Complete

Type: If
Condition: {{ $json.status }} equals complete
True: Continue to next node
False: Loop back to Wait node

Example: Avatar video from text input

This workflow takes a text input, generates speech, and creates an avatar video.

Node 1: Manual Trigger / Webhook

Start the workflow manually or via a webhook with a text field in the body.

Node 2: Upload Portrait Image

If you have a fixed portrait, upload it once and reuse the asset ID. Otherwise, create and upload:

Type: HTTP Request
Method: POST
URL: https://api.hedra.com/web-app/public/assets
Body (JSON):

{
  "name": "portrait.png",
  "type": "image"
}

Node 3: Upload File

Type: HTTP Request
Method: POST
URL: https://api.hedra.com/web-app/public/assets/{{ $json.id }}/upload
Authentication: Header Auth → Hedra API Key
Body: Form-Data, attach your portrait image file

Node 4: Generate Avatar Video with Inline TTS

Use audio_generation to skip a separate TTS step:

Type: HTTP Request
Method: POST
URL: https://api.hedra.com/web-app/public/generations
Body (JSON):

{
  "type": "video",
  "model_slug": "together/hedra-avatar",
  "start_keyframe_id": "{{ $('Upload Portrait Image').item.json.id }}",
  "audio_generation": {
    "type": "text_to_speech",
    "voice_id": "f412c62f-e94f-41c0-bfc6-97f63289941c",
    "text": "{{ $('Manual Trigger').item.json.text }}"
  },
  "generated_video_inputs": {
    "text_prompt": "A person speaking to the camera",
    "aspect_ratio": "9:16",
    "resolution": "540p"
  }
}

Node 5: Poll Until Complete

Use a Wait + HTTP Request + If loop (same pattern as the image example above) to poll GET /generations/{id}/status until status is "complete".

Polling pattern

Most Hedra generations are asynchronous. Use this reusable polling pattern in your n8n workflows:

[Generate] → [Wait 15-30s] → [Check Status] → [If complete?]
                  ↑                                  │
                  └──────── No ──────────────────────┘
                                                     │
                                              Yes → [Next step]

For short generations (images, TTS), a 15-second wait is usually enough. For long-form avatar videos, use 60-second intervals and check the progress field (0-1) in the status response.

Tips

Reuse asset IDs. If you use the same portrait or audio across runs, upload once and store the asset_id for reuse.
Use n8n variables. Store your Hedra model IDs and voice IDs as n8n workflow variables for easy updates.
Error handling. Add an If node to check for status equal to "error" and branch to a notification or retry path.

Getting Started

Guides

API Reference

Automate Content with n8n (Legacy API)

Authentication setup

Example: Generate an image on a schedule

Node 1: Schedule Trigger

Node 2: Generate Image

Node 3: Wait

Node 4: Check Status

Node 5: Check if Complete

Example: Avatar video from text input

Node 1: Manual Trigger / Webhook

Node 2: Upload Portrait Image

Node 3: Upload File

Node 4: Generate Avatar Video with Inline TTS

Node 5: Poll Until Complete

Polling pattern

Tips

​Authentication setup

​Example: Generate an image on a schedule

​Node 1: Schedule Trigger

​Node 2: Generate Image

​Node 3: Wait

​Node 4: Check Status

​Node 5: Check if Complete

​Example: Avatar video from text input

​Node 1: Manual Trigger / Webhook

​Node 2: Upload Portrait Image

​Node 3: Upload File

​Node 4: Generate Avatar Video with Inline TTS

​Node 5: Poll Until Complete

​Polling pattern

​Tips

Authentication setup

Example: Generate an image on a schedule

Node 1: Schedule Trigger

Node 2: Generate Image

Node 3: Wait

Node 4: Check Status

Node 5: Check if Complete

Example: Avatar video from text input

Node 1: Manual Trigger / Webhook

Node 2: Upload Portrait Image

Node 3: Upload File

Node 4: Generate Avatar Video with Inline TTS

Node 5: Poll Until Complete

Polling pattern

Tips