Recursos para Desenvolvedores

Prompts

Pesquise exemplos de prompts publicados e leia as mídias de exemplo e as imagens de referência de cada prompt.

A Prompts API retorna exemplos de prompts publicados com os endpoints que podem executá-los. Ela é pública e não exige chave de API.

Listar prompts

SHELL

curl "https://runapi.ai/api/v1/prompts?modality=video&q=sunset&limit=20"

Filtre com modality, category, tags (separadas por vírgula), q e model. Pagine com page e limit (no máximo 100). A resposta contém prompts e pagination (page, per_page, total, pages).

Obter um prompt

SHELL

curl "https://runapi.ai/api/v1/prompts/PROMPT_ID"

Campos do prompt

Campo Descrição id ID do prompt. title, prompt, negative_prompt Título, texto do prompt e prompt negativo opcional. language, modality, input_kind, category, tags Metadados do prompt. preview_url URL da imagem de capa, ou null quando o prompt não tem imagem de exemplo. media Todos os itens de exemplo e de referência, na ordem de origem. Veja abaixo. source_url, published_at Página de origem e horário de publicação. eligible_endpoints Endpoints que podem executar o prompt.

Mídia

Cada item de media descreve um arquivo anexado ao prompt:

Campo Descrição role example_output ou preview para resultados de exemplo; reference_input para uma imagem de referência que o usuário deve fornecer. Pode ser null. modality image, video ou audio, em minúsculas. Pode ser null. media_type Tipo MIME, como video/mp4. Pode ser null. url URL do arquivo. O item usado como capa tem a mesma URL que preview_url. alt_text Descrição em texto, ou null.

JSON

"media": [
  {"role": "example_output", "modality": "video", "media_type": "video/mp4", "url": "https://example.test/clip.mp4", "alt_text": null},
  {"role": "reference_input", "modality": "image", "media_type": "image/png", "url": "https://example.test/face.png", "alt_text": "Face"}
]

Um prompt com um item reference_input só gera resultados como os exemplos quando você fornece sua própria imagem de referência. Um prompt só com vídeo tem preview_url: null; leia os vídeos em media.