개발자 리소스

Prompts

게시된 프롬프트 예시를 검색하고 각 프롬프트의 예시 미디어와 참조 이미지를 확인합니다.

Prompts API는 게시된 프롬프트 예시와 이를 실행할 수 있는 엔드포인트를 반환합니다. 공개 API이므로 API 키가 필요하지 않습니다.

프롬프트 목록

SHELL

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

modality, category, tags(쉼표로 구분), q, model로 필터링하고 page와 limit(최대 100)로 페이지를 나눕니다. 응답에는 prompts와 pagination(page, per_page, total, pages)이 포함됩니다.

프롬프트 조회

SHELL

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

프롬프트 필드

필드 설명 id 프롬프트 ID. title, prompt, negative_prompt 제목, 프롬프트 텍스트, 선택 사항인 네거티브 프롬프트. language, modality, input_kind, category, tags 프롬프트 메타데이터. preview_url 커버 이미지 URL. 예시 이미지가 없으면 null. media 모든 예시 및 참조 항목(원본 순서). 아래 참고. source_url, published_at 원본 출처 페이지와 게시 시각. eligible_endpoints 프롬프트를 실행할 수 있는 엔드포인트.

미디어

media의 각 항목은 프롬프트에 첨부된 파일 하나를 나타냅니다.

필드 설명 role example_output 또는 preview는 예시 결과, reference_input은 사용자가 제공해야 하는 참조 이미지입니다. null일 수 있습니다. modality image, video, audio(소문자). null일 수 있습니다. media_type MIME 유형(예: video/mp4). null일 수 있습니다. url 파일 URL. 커버로 사용되는 항목은 preview_url과 URL이 같습니다. alt_text 텍스트 설명 또는 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"}
]

reference_input 항목이 있는 프롬프트는 직접 참조 이미지를 제공해야 예시와 비슷한 결과를 얻을 수 있습니다. 동영상만 있는 프롬프트는 preview_url: null이므로 동영상은 media에서 읽으세요.