호출할 API 엔드포인트 선택

Modelflare는 여러 프로토콜에 걸쳐 하나의 API 키를 사용합니다. JSON 봉투는 모든 모델에서 동일하지 않습니다. 먼저 가족을 선택한 후 매칭 가이드나 모델 페이지에서 요청사항을 복사하세요.

기본 URL

https://modelflare.dev/v1

중국을 향한 EdgeOne 트래픽은 동일한 애플리케이션에 https://origin.modelflare.dev/v1을 사용할 수 있습니다. 요청을 보내기 전에 호스트를 선택하십시오. 호스트 간에 진행 중인 POST를 리디렉션하지 마십시오.

Anthropic 클라이언트는 예외입니다. ANTHROPIC_BASE_URL은 https://modelflare.dev입니다(/v1가 아닌 사이트 원본). 공식 Claude Code CLI는 메시지 경로 자체를 추가합니다. Claude Code를 참조하세요.

인증

Authorization: Bearer YOUR_MODELFLARE_API_KEY

비디오 폴링 및 다운로드를 포함하여 모든 요청에 대해 이 헤더를 보냅니다. 콘솔에서 키를 생성합니다. 세부정보: 인증.

가족

Modelflare API 키 1개https://modelflare.dev

Chat Completions

POST /v1/chat/completions

OpenAI 호환 채팅.

Responses

POST /v1/responses

Codex 및 Grok Build.

Anthropic Messages

ANTHROPIC_BASE_URL=https://modelflare.dev

Claude Code CLI는 메시지 경로 자체를 추가합니다.

이미지

POST /v1/images/generations

GPT 이미지, Wan 이미지, Seedream.

Gemini 네이티브

POST /v1/models/{model}:generateContent

Gemini 이미지 모델. Gemini CLI는 /v1beta 철자 자체를 사용합니다.

영상

POST /v1/videos

작업을 생성합니다. 작업을 폴링한 다음 결과를 다운로드합니다.

Seedance 자산

POST /volc/asset/*

Seedance 자산 그룹 및 제공자 측 미디어 ID를 관리합니다.

모델

GET /v1/models

현재 키가 호출할 수 있는 것.

하나의 키와 하나의 호스트이지만 가족마다 다른 요청 계약이 있습니다. 아래 표는 각각의 가이드 또는 모델 페이지로 연결됩니다.

가족	일반적인 항목	다음 용도로 사용하세요.
Chat Completions	POST /v1/chat/completions	OpenAI 호환 채팅. 첫 번째 요청: 빠른 시작.
Responses	POST /v1/responses	Codex 및 Grok Build.
Anthropic Messages	Anthropic 호환 메시지	Claude Code.
이미지	POST /v1/images/generations	GPT 이미지, Wan 이미지, Seedream. 정확한 필드: 이미지 모델.
Gemini 네이티브	POST /v1/models/{model}:generateContent	Gemini 이미지 모델; origin.modelflare.dev에도 게재되었습니다. Gemini CLI는 modelflare.dev만 서비스하는 /v1beta 아래에 동일한 경로를 구축합니다.
영상	POST /v1/videos	Seedance, Wan, Kling 및 기타 비동기 비디오 모델. GET /v1/videos/{task_id}을 폴링하고 GET /v1/videos/{task_id}/content을 다운로드합니다. 정확한 엔벨로프: 비디오 모델.
Seedance 자산	POST /volc/asset/*	제공자 측 자산 그룹 및 미디어를 생성, 쿼리, 업데이트 및 삭제합니다. Seedance자산관리를 참조하세요.
모델	GET /v1/models	현재 키가 호출할 수 있는 모델을 나열합니다.

잘못된 엔드포인트 이미지 및 비디오 요청은 unsupported_endpoint으로 거부됩니다. Gemini 이미지 필드를 /v1/images/*로 보내거나 GPT 이미지 필드를 generateContent로 보내지 마십시오. Chat Completions 필드를 Responses 또는 Anthropic 클라이언트에 혼합하지 마십시오.

이미지 및 비디오는 스마트 API 키 또는 media 그룹 API 키와 함께 작동합니다. 결과 URL은 만료될 수 있습니다. 비디오 작업이 성공한 후 파일을 전송합니다.

Seedance 자산 관리 호출은 스마트 API 키 또는 media 그룹 API 키와 같은 동일한 키를 허용합니다. 자산 생성은 비동기식입니다. Active까지 GetAsset을 사용한 다음 지원되는 Seedance 요청에서 반환된 asset://<ID>를 변경하지 않고 전달합니다. 게이트웨이는 사용자별로 자산 소유권을 유지하며 별도의 리소스 관리 비용을 추가하지 않습니다.

이 키에 대한 모델 목록

GEThttps://modelflare.dev/v1/models

bash

curl https://modelflare.dev/v1/models \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

응답은 현재 키가 호출할 수 있는 모델을 나열합니다. 이는 가격, 그룹 및 프로토콜 레이블을 포함하는 모델 및 가격을 대체하지 않습니다. JSON model 필드에 정확한 id를 사용하세요. 모델 및 그룹을 참조하세요.