Construisez avec l'API Podfeed

Accédez au même pipeline IA que l'interface Podfeed. Générez de l'audio de style podcast à partir de texte, URLs, fichiers, sujets, YouTube, et plus.

Exemple de requête et réponse d'API

POST /api/v1/audios HTTP/1.1
  x-api-key: <API_KEY>
  Content-Type: application/json

  {
    "inputType": "url",
    "mode": "dialogue",
    "websiteUrl": "https://podfeed.ai",
    "hostVoice": "gemini-archird",
    "coHostVoice": "gemini-achernar",
    "language": "en-US",
    "level": "intermediate",
    "length": "medium",
    "userInstructions": "Prioritize the sections on onboarding and pricing."
  }

  // 202 Accepted
  {
    "task_id": "task_3a8…",
    "status": "processing"
  }

Ce que vous pouvez construire

L'API expose les mêmes capacités que l'application : ingestion de contenu, génération de script IA et synthèse vocale naturelle.

Même backend que l'UI

Parité complète des fonctionnalités avec le pipeline de génération de l'application Podfeed.

Monologue ou dialogue

Choisissez une seule voix ou un dialogue à deux voix avec hôte et co-animateur.

Multiples fournisseurs de voix

Choisissez des voix de Google, ElevenLabs, OpenAI et plus.

Multiples types d'entrée

Texte, URLs, PDFs, fichiers, sujets (recherche), YouTube, et URLs d'épisodes de podcast.

Recherche autonome

Fournissez un sujet ; l'API recherche et génère un épisode complet.

Démarrage rapide (Python)

Installez le SDK, définissez PODFEED_API_KEY et créez votre premier audio.

pip install podfeed-sdk

export PODFEED_API_KEY="your-api-key-here"

from podfeed import (
    PodfeedClient,
    AudioGenerationRequest,
    InputContent,
    VoiceConfig,
    ContentConfig,
)

client = PodfeedClient()  # uses PODFEED_API_KEY env var

task = client.generate_audio(
    request=AudioGenerationRequest(
        input_type="url",
        mode="dialogue",
        input_content=InputContent(url="https://podfeed.ai/faq"),
        voice_config=VoiceConfig(
            host_voice="gemini-puck", cohost_voice="gemini-achird"
        ),
        content_config=ContentConfig(
            level="intermediate",
            length="medium",
            language="en-US",
        ),
    )
)

result = client.wait_for_completion(task["task_id"])  # blocks until done
print(result["result"]["audio_url"])

Pour plus d'exemples, voir podfeed-sdk-samples.

Référence API

Référence complète des endpoints de l'API REST Podfeed. Toutes les requêtes nécessitent une clé API envoyée via le header x-api-key.

Authentification

Incluez votre clé API dans chaque requête via le header x-api-key. Vous pouvez obtenir une clé depuis votre tableau de bord Podfeed.

x-api-key: your-api-key-here

URL de base : https://api.podfeed.ai

Endpoints

Cliquez sur un endpoint pour voir les détails de la requête et de la réponse.

Démarre une tâche de génération audio à partir de texte, URL, fichier, sujet, script ou sources combinées.

Champ	Type	Requis	Description
`inputType`	`string`	requis	Type of input content. `fileurltexttopicscript`
`mode`	`string`	requis	Audio generation mode. `monologuedialogue` Par défaut : `dialogue`
`websiteUrl`	`string`	optionnel	Website / YouTube / podcast URL (when inputType="url").
`textContent`	`string`	optionnel	Plain text up to 50 000 chars (when inputType="text").
`topic`	`string`	optionnel	Topic for AI-generated research content (when inputType="topic").
`scriptContent`	`string`	optionnel	Pre-written script up to 100 000 chars (when inputType="script").
`gcsUris`	`string[]`	optionnel	GCS URIs of pre-uploaded files (when inputType="file"). Get URIs from /upload-urls.
`voice`	`string`	optionnel	Voice ID for monologue mode.
`hostVoice`	`string`	optionnel	Host voice ID for dialogue mode.
`coHostVoice`	`string`	optionnel	Co-host voice ID for dialogue mode.
`language`	`string`	optionnel	Language code (e.g. "en-US", "es", "fr"). Par défaut : `en-US`
`level`	`string`	optionnel	Content complexity level. `beginnerintermediateadvanced` Par défaut : `intermediate`
`length`	`string`	optionnel	Content length preference. `shortmediumlong` Par défaut : `medium`
`userInstructions`	`string`	optionnel	Custom instructions for content generation.
`voiceInstructions`	`string`	optionnel	Custom instructions for voice synthesis (supported voices only).
`emphasis`	`string`	optionnel	Content emphasis or focus area.
`readMode`	`boolean`	optionnel	Direct text reading mode (no content enhancement). Par défaut : `false`
`feedId`	`string`	optionnel	Automatically add the generated audio to this feed as an episode.

Champ	Type	Requis	Description
`task_id`	`string`	optionnel	Unique identifier for the generation task.
`status`	`string`	optionnel	Always "processing" on creation. `processing`

Interroge le statut d'une tâche de génération. Retourne la progression et le résultat une fois terminé.

Champ	Type	Requis	Description
`task_id`	`string`	requis	The task ID returned from the generate endpoint.

Champ	Type	Requis	Description
`task_id`	`string`	optionnel	The task identifier.
`status`	`string`	optionnel	Current task status. `processingcompletedfailed`
`created_at`	`string (ISO 8601)`	optionnel	When the task was created.
`updated_at`	`string (ISO 8601)`	optionnel	When the task was last updated.
`error`	`string`	optionnel	Error message (only when status="failed").
`result`	`object`	optionnel	Result object (only when status="completed"): { audio_id, audio_url, title, description }.

Liste tous les audios générés pour l'utilisateur authentifié.

Champ	Type	Requis	Description
`limit`	`integer`	optionnel	Max audios to return (1–100). Par défaut : `20`
`offset`	`integer`	optionnel	Number of audios to skip. Par défaut : `0`
`status`	`string`	optionnel	Filter by generation status. `processingcompletedfailed`

Champ	Type	Requis	Description
`audios`	`array`	optionnel	Array of audio summaries: { audio_id, title, duration_seconds, status, created_at, file_size_bytes }.
`total_count`	`integer`	optionnel	Total number of audios (for pagination).
`limit`	`integer`	optionnel	Limit used in the request.
`offset`	`integer`	optionnel	Offset used in the request.

Obtient les métadonnées d'un audio spécifique (URL, titre, transcription, durée, etc.).

Champ	Type	Requis	Description
`audio_id`	`string`	requis	The unique identifier of the audio.

Champ	Type	Requis	Description
`audio_id`	`string`	optionnel	Audio identifier.
`audio_url`	`string`	optionnel	Signed URL to download the audio file.
`title`	`string`	optionnel	Generated or provided title.
`description`	`string`	optionnel	Content description / summary.
`transcript`	`string`	optionnel	Full transcript of the audio.
`created_at`	`string (ISO 8601)`	optionnel	Creation timestamp.
`user_controls`	`object`	optionnel	Generation parameters used (mode, voice, language, level, length).

Supprime définitivement un audio généré.

Champ	Type	Requis	Description
`audio_id`	`string`	requis	The unique identifier of the audio to delete.

Champ	Type	Requis	Description
`success`	`boolean`	optionnel	true when the audio was deleted.

Obtient toutes les voix disponibles groupées par langue, avec infos de fournisseur et coût.

Champ	Type	Requis	Description
`{language_code}`	`object`	optionnel	Top-level keys are language codes (e.g. "en-US", "es", "fr").
`{language_code}.language_name`	`string`	optionnel	Human-readable language name (e.g. "English").
`{language_code}.voices`	`object`	optionnel	Map of voice_id → { tts, credits_multiplier, display_name, gender, supported_modes }.

Crée un nouveau feed podcast pour organiser les épisodes.

Champ	Type	Requis	Description
`name`	`string`	requis	Name of the podcast feed.
`description`	`string`	optionnel	Feed description. Par défaut : `My personal podcast feed (podfeed.ai)`
`image_url`	`string`	optionnel	Cover image URL for the feed.

Champ	Type	Requis	Description
`feed`	`object`	optionnel	Created feed object: { id, name, description, image_url, episode_count, rss_url, created_at }.

Liste tous les feeds podcast de l'utilisateur authentifié.

Champ	Type	Requis	Description
`feeds`	`array`	optionnel	Array of feed objects: { id, name, description, image_url, episode_count, rss_url }.

Obtient les détails du feed incluant les épisodes et l'URL RSS.

Champ	Type	Requis	Description
`feed_id`	`string`	requis	The unique identifier of the feed.

Champ	Type	Requis	Description
`feed`	`object`	optionnel	Feed object with episodes: { id, name, description, image_url, episode_count, rss_url, episodes }.

Ajoute un audio généré à un feed en tant qu'épisode de podcast.

Champ	Type	Requis	Description
`audio_id`	`string`	requis	The audio to add as an episode.

Champ	Type	Requis	Description
`feed_id`	`string`	optionnel	Target feed ID. If omitted, uses the first feed or creates one.
`episode_title`	`string`	optionnel	Episode title. Auto-generated as "Episode N" if omitted.

Champ	Type	Requis	Description
`message`	`string`	optionnel	Success message.
`episode`	`object`	optionnel	Created episode object.
`feed_id`	`string`	optionnel	The feed the episode was added to.

Génère un lien de partage public pour un audio.

Champ	Type	Requis	Description
`audio_id`	`string`	requis	The ID of the audio to share.

Champ	Type	Requis	Description
`url_token`	`string`	optionnel	Token for accessing the shared audio.

Demande des URLs signées pour la génération basée sur des fichiers (PDF, audio, vidéo).

Champ	Type	Requis	Description
`files`	`array`	requis	Array of file metadata objects: { filename (string, required), contentType (string), size (integer, required, bytes) }.

Champ	Type	Requis	Description
`urls`	`array`	optionnel	Array of upload objects: { filename, signedUrl, gcsUri }. PUT the file to signedUrl, then pass gcsUri to /audios.

Types d'entrée supportés

L'endpoint de génération accepte ces types d'entrée. Utilisez content_type="sources" pour combiner jusqu'à 10 entrées en une seule requête.

url

URL de site web, vidéo YouTube, Apple Podcast ou épisode Spotify.

text

Texte brut ou contenu long à convertir en audio.

topic

Un sujet — l'API effectuera des recherches autonomes avant de générer.

script

Votre propre script. Dialogue : alternez les lignes HOST:/COHOST:. Monologue : texte simple.

file

Téléchargez des fichiers PDF, audio ou vidéo via des URLs signées.

sources

Combinez jusqu'à 10 URLs, blocs de texte et fichiers en une requête.

Codes d'erreur

Code	Signification
`400`	Bad Request — paramètres invalides ou champs obligatoires manquants.
`401`	Unauthorized — clé API manquante ou invalide.
`403`	Forbidden — crédits insuffisants ou fonctionnalité non disponible sur votre plan.
`404`	Not Found — la ressource demandée n'existe pas.
`429`	Too Many Requests — limite de débit dépassée. Réessayez avec un backoff exponentiel.
`500`	Internal Server Error — quelque chose s'est mal passé de notre côté. Réessayez ou contactez le support.

SDKs & Ressources

PythonDisponible

SDK Python complet avec modèles Pydantic, polling asynchrone des tâches, upload de fichiers et gestion complète des erreurs.

REST

Utilisez l'API REST directement depuis n'importe quel langage. Des wrappers SDK supplémentaires sont prévus.

SDK Node.js (bientôt)

SDK Go (bientôt)

PRICING

Tarifs API

Tarification basée sur des crédits. Même modèle de crédits que l'UI. Paliers d'utilisation détaillés bientôt.

Standard

Basé sur l'usage avec crédits

100 crédits = 5 $

Facturation basée sur des crédits

Même crédits que la version UI

Support email standard

Paliers d'utilisation prévus

Entreprise

Tarifs volume, SLA et intégrations personnalisées

Personnalisé

Support prioritaire avec canal dédié

SLA de disponibilité et de temps de réponse

Environnement dédié / options VPC

Intégrations personnalisées et SSO