Construa com a API do Podfeed

Acesse o mesmo pipeline de IA da interface do Podfeed. Gere áudio estilo podcast a partir de texto, URLs, arquivos, tópicos, YouTube e mais.

Exemplo de requisição e resposta da 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"
  }

O que você pode construir

A API expõe as mesmas capacidades do app: ingestão de conteúdo, geração de roteiro com IA e TTS natural.

Mesmo backend da UI

Paridade total com o pipeline de geração do app Podfeed.

Monólogo ou diálogo

Escolha uma só voz ou duas vozes (apresentador e coapresentador).

Múltiplos provedores de voz

Escolha vozes do Google, ElevenLabs, OpenAI e mais.

Múltiplos tipos de entrada

Texto, URLs, PDFs, arquivos, tópicos (pesquisa), YouTube e URLs de episódios de podcast.

Pesquisa autônoma

Forneça um tópico; a API pesquisa e gera um episódio completo.

Início rápido (Python)

Instale o SDK, defina PODFEED_API_KEY e crie seu primeiro áudio.

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"])

Para mais exemplos, consulte podfeed-sdk-samples.

Referência da API

Referência completa dos endpoints da API REST do Podfeed. Todas as requisições exigem uma chave de API enviada pelo header x-api-key.

Autenticação

Inclua sua chave de API em cada requisição usando o header x-api-key. Você pode obter uma chave no seu painel do Podfeed.

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

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

Endpoints

Clique em um endpoint para ver detalhes da requisição e resposta.

Inicia uma tarefa de geração de áudio a partir de texto, URL, arquivo, tópico, roteiro ou fontes combinadas.

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

Campo	Tipo	Obrigatório	Descrição
`task_id`	`string`	opcional	Unique identifier for the generation task.
`status`	`string`	opcional	Always "processing" on creation. `processing`

Consulta o status de uma tarefa de geração. Retorna progresso e resultado quando concluído.

Campo	Tipo	Obrigatório	Descrição
`task_id`	`string`	obrigatório	The task ID returned from the generate endpoint.

Campo	Tipo	Obrigatório	Descrição
`task_id`	`string`	opcional	The task identifier.
`status`	`string`	opcional	Current task status. `processingcompletedfailed`
`created_at`	`string (ISO 8601)`	opcional	When the task was created.
`updated_at`	`string (ISO 8601)`	opcional	When the task was last updated.
`error`	`string`	opcional	Error message (only when status="failed").
`result`	`object`	opcional	Result object (only when status="completed"): { audio_id, audio_url, title, description }.

Lista todos os áudios gerados pelo usuário autenticado.

Campo	Tipo	Obrigatório	Descrição
`limit`	`integer`	opcional	Max audios to return (1–100). Padrão: `20`
`offset`	`integer`	opcional	Number of audios to skip. Padrão: `0`
`status`	`string`	opcional	Filter by generation status. `processingcompletedfailed`

Campo	Tipo	Obrigatório	Descrição
`audios`	`array`	opcional	Array of audio summaries: { audio_id, title, duration_seconds, status, created_at, file_size_bytes }.
`total_count`	`integer`	opcional	Total number of audios (for pagination).
`limit`	`integer`	opcional	Limit used in the request.
`offset`	`integer`	opcional	Offset used in the request.

Obtém metadados de um áudio específico (URL, título, transcrição, duração, etc.).

Campo	Tipo	Obrigatório	Descrição
`audio_id`	`string`	obrigatório	The unique identifier of the audio.

Campo	Tipo	Obrigatório	Descrição
`audio_id`	`string`	opcional	Audio identifier.
`audio_url`	`string`	opcional	Signed URL to download the audio file.
`title`	`string`	opcional	Generated or provided title.
`description`	`string`	opcional	Content description / summary.
`transcript`	`string`	opcional	Full transcript of the audio.
`created_at`	`string (ISO 8601)`	opcional	Creation timestamp.
`user_controls`	`object`	opcional	Generation parameters used (mode, voice, language, level, length).

Exclui permanentemente um áudio gerado.

Campo	Tipo	Obrigatório	Descrição
`audio_id`	`string`	obrigatório	The unique identifier of the audio to delete.

Campo	Tipo	Obrigatório	Descrição
`success`	`boolean`	opcional	true when the audio was deleted.

Obtém todas as vozes disponíveis agrupadas por idioma, com info de provedor e custo.

Campo	Tipo	Obrigatório	Descrição
`{language_code}`	`object`	opcional	Top-level keys are language codes (e.g. "en-US", "es", "fr").
`{language_code}.language_name`	`string`	opcional	Human-readable language name (e.g. "English").
`{language_code}.voices`	`object`	opcional	Map of voice_id → { tts, credits_multiplier, display_name, gender, supported_modes }.

Cria um novo feed de podcast para organizar episódios.

Campo	Tipo	Obrigatório	Descrição
`name`	`string`	obrigatório	Name of the podcast feed.
`description`	`string`	opcional	Feed description. Padrão: `My personal podcast feed (podfeed.ai)`
`image_url`	`string`	opcional	Cover image URL for the feed.

Campo	Tipo	Obrigatório	Descrição
`feed`	`object`	opcional	Created feed object: { id, name, description, image_url, episode_count, rss_url, created_at }.

Lista todos os feeds de podcast do usuário autenticado.

Campo	Tipo	Obrigatório	Descrição
`feeds`	`array`	opcional	Array of feed objects: { id, name, description, image_url, episode_count, rss_url }.

Obtém detalhes do feed incluindo episódios e URL do RSS.

Campo	Tipo	Obrigatório	Descrição
`feed_id`	`string`	obrigatório	The unique identifier of the feed.

Campo	Tipo	Obrigatório	Descrição
`feed`	`object`	opcional	Feed object with episodes: { id, name, description, image_url, episode_count, rss_url, episodes }.

Adiciona um áudio gerado a um feed como episódio de podcast.

Campo	Tipo	Obrigatório	Descrição
`audio_id`	`string`	obrigatório	The audio to add as an episode.

Campo	Tipo	Obrigatório	Descrição
`feed_id`	`string`	opcional	Target feed ID. If omitted, uses the first feed or creates one.
`episode_title`	`string`	opcional	Episode title. Auto-generated as "Episode N" if omitted.

Campo	Tipo	Obrigatório	Descrição
`message`	`string`	opcional	Success message.
`episode`	`object`	opcional	Created episode object.
`feed_id`	`string`	opcional	The feed the episode was added to.

Gera um link público de compartilhamento para um áudio.

Campo	Tipo	Obrigatório	Descrição
`audio_id`	`string`	obrigatório	The ID of the audio to share.

Campo	Tipo	Obrigatório	Descrição
`url_token`	`string`	opcional	Token for accessing the shared audio.

Solicita URLs assinadas de upload para geração baseada em arquivos (PDF, áudio, vídeo).

Campo	Tipo	Obrigatório	Descrição
`files`	`array`	obrigatório	Array of file metadata objects: { filename (string, required), contentType (string), size (integer, required, bytes) }.

Campo	Tipo	Obrigatório	Descrição
`urls`	`array`	opcional	Array of upload objects: { filename, signedUrl, gcsUri }. PUT the file to signedUrl, then pass gcsUri to /audios.

Tipos de Entrada Suportados

O endpoint de geração aceita estes tipos de entrada. Use content_type="sources" para combinar até 10 entradas em uma única requisição.

url

URL de site, vídeo do YouTube, Apple Podcast ou episódio do Spotify.

text

Texto simples ou conteúdo longo para converter em áudio.

topic

Um tópico — a API pesquisará autonomamente antes de gerar.

script

Seu próprio roteiro. Diálogo: alterne linhas HOST:/COHOST:. Monólogo: texto simples.

file

Upload de arquivos PDF, áudio ou vídeo via URLs assinadas.

sources

Combine até 10 URLs, blocos de texto e arquivos em uma requisição.

Códigos de Erro

Código	Significado
`400`	Bad Request — parâmetros inválidos ou campos obrigatórios ausentes.
`401`	Unauthorized — chave de API ausente ou inválida.
`403`	Forbidden — créditos insuficientes ou recurso indisponível no seu plano.
`404`	Not Found — o recurso solicitado não existe.
`429`	Too Many Requests — limite de taxa excedido. Tente novamente com backoff exponencial.
`500`	Internal Server Error — algo deu errado do nosso lado. Tente novamente ou contate o suporte.

SDKs e Recursos

PythonDisponível

SDK Python completo com modelos Pydantic, polling assíncrono de tarefas, upload de arquivos e tratamento abrangente de erros.

REST

Use a API REST diretamente de qualquer linguagem. Wrappers de SDK adicionais estão planejados.

SDK em Node.js (em breve)

SDK em Go (em breve)

PRICING

Preços da API

Preços baseados em créditos. Mesmo modelo de créditos da UI. Detalhes dos níveis de uso em breve.

Regular

Baseado em uso com créditos

100 créditos = US$5

Cobrança baseada em créditos

Mesmos créditos da versão UI

Suporte por email padrão

Níveis de uso planejados

Enterprise

Preços por volume, SLAs e integrações personalizadas

Personalizado

Suporte prioritário com canal dedicado

SLAs de uptime e tempo de resposta

Ambiente dedicado / opções de VPC

Integrações personalizadas e SSO