무료 비전 API
비전 API는 LLM이 이미지를 읽게 합니다. 사진 설명, 영수증 읽기, 차트 설명을 요청할 수 있습니다. FreeLLMAPI 카탈로그에는 이미지를 받는 무료 모델 제공 항목이 78개 있습니다. 이미지는 표준 OpenAI 형식으로 보내며, 라우터가 비전 모델을 선택합니다. 이 가이드는 모델, 제공업체별 크기 한도, 실제로 작동하는 코드를 보여 줍니다.
코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.
이미지 입력 작동 방식
messages 배열에 image_url 콘텐츠 블록으로 이미지를 보내십시오. URL은 base64 바이트를 담은 data: URL이거나 http(s) URL일 수 있습니다. /v1/chat/completions를 사용하십시오. /v1/responses 엔드포인트는 아직 이미지를 받지 않습니다.
- 자동 라우팅: 요청에 이미지가 있으면 라우터는 비전 모델만 사용합니다. 해당 요청에서는 텍스트 전용 모델을 무시합니다.
- 자동 전환: 한 비전 제공업체가 한도에 도달하면 라우터는 체인의 다음 비전 모델을 시도합니다.
- 명확한 오류: 활성화된 비전 모델이 없으면
code: "no_vision_model"과 함께 오류 422를 받습니다. 이미지가 조용히 버려지지 않습니다.
오늘의 무료 비전 모델
이 표는 오늘 카탈로그에서 이미지 입력을 지원하는 가장 성능이 좋은 무료 모델을 보여 줍니다. 실시간 카탈로그에서 가져온 데이터입니다. 한 행에는 같은 모델을 제공하는 여러 제공업체가 나열될 수 있습니다.
| 모델 | 무료 제공 | 컨텍스트 | 무료 한도 (가장 좋은 조건) | 도구 | 비전 |
|---|---|---|---|---|---|
| GLM 5.3 Flash | UnoRouter | 1M | 1 요청/분 1 req/min per model | 예 | 예 |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 예 | 예 |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 요청/분 50 요청/일 50 req/day account-wide (1,000 after a $10 purchase) | 예 | 예 |
| Qwen3.8 27B | ElectronHub, Groq | 262K | 30 요청/분 250 요청/일 70,000 토큰/분 ~6M | 예 | 예 |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | 예 | 예 |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.8 Live | Google AI Studio | - | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Moondream 3.1 9B A2B | Cloudflare Workers AI, Moondream | 33K | ~10-20M | 아니요 | 예 |
| Moondream 3 Preview | Moondream | - | $5/month shared workspace usage credits | 아니요 | 예 |
일치하는 무료 모델 67개 중 15개를 표시합니다. 모든 모델 보기.
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
Gemini 모델은 가장 큰 컨텍스트를 제공하며 많은 이미지를 받습니다. Groq와 Cloudflare의 Qwen 3.8 27B는 Google이 아닌 제공업체 중 빠른 선택입니다. Moondream은 이미지 작업을 위해 만들어졌지만 출력은 4,096 토큰으로 제한됩니다.
1단계: FreeLLMAPI 설치 및 키 추가
FreeLLMAPI는 오픈 소스입니다. Docker에서 내 컴퓨터에 실행됩니다. 제공업체 키는 내 컴퓨터에 보관됩니다.
설치 (macOS 또는 Linux)
curl -fsSL https://freellmapi.co/install.sh | bashhttp://localhost:3001에서 대시보드를 여십시오. Keys 페이지에 Google AI Studio 키와 다른 키 하나를 추가하십시오. Fallback Chain 페이지에서 비전 모델에는 Vision 배지가 붙어 있습니다. 최소 하나가 활성화되어 있는지 확인하십시오. Keys 페이지에서 통합 키를 복사하십시오.
2단계: 이미지 보내기
curl: URL의 이미지
curl http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "Describe this image in two sentences."},
{"type": "image_url", "image_url": {"url": "https://upload.wikimedia.org/wikipedia/commons/4/47/PNG_transparency_demonstration_1.png"}}
]
}]
}'Python: base64로 된 로컬 파일
import base64
from openai import OpenAI
client = OpenAI(base_url="http://localhost:3001/v1", api_key="<unified-key>")
with open("receipt.jpg", "rb") as fh:
b64 = base64.b64encode(fh.read()).decode()
resp = client.chat.completions.with_raw_response.create(
model="auto", # the router selects a vision model
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "List each item and price on this receipt as JSON."},
{"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{b64}"}},
],
}],
)
print("Routed via:", resp.headers.get("x-routed-via"))
print(resp.parse().choices[0].message.content)data URL에는 올바른 MIME 유형을 사용하십시오. 예: image/png 또는 image/jpeg. 이미지를 여러 개 보내려면 같은 메시지에 image_url 블록을 더 추가하십시오.
제공업체별 이미지 한도
| 제공업체 | 한도 (공식) | 해야 할 일 |
|---|---|---|
| Google Gemini | 인라인 이미지를 포함한 총 요청 크기: 20 MB. 형식: PNG, JPEG, WEBP, HEIC, HEIF | 보내기 전에 큰 사진을 줄이십시오 |
| Google Gemini | 384x384 픽셀 이하 이미지는 258 토큰입니다. 더 큰 이미지는 각각 258 토큰인 768x768 타일로 나뉩니다 | 960x540 이미지는 타일 6개를 사용하며, 약 1,548 토큰입니다 |
| Groq (Qwen 3.8 27B) | 요청당 최대 이미지 3개. 이미지 URL이 있는 요청은 최대 20 MB | Groq 모델에는 이미지를 최대 3개까지 보내십시오 |
| Moondream | base64 data URL만 지원. 원격 이미지 URL은 지원하지 않음 | 링크가 아니라 이미지 바이트를 보내십시오 |
이미지 토큰은 무료 등급의 분당 토큰 한도에 포함됩니다. 큰 이미지 다섯 개가 든 요청은 작은 제공업체의 한도보다 클 수 있습니다. 세부 정보가 필요 없다면 이미지를 줄이십시오. 예: 긴 변을 1024 픽셀로 줄이기.
이미지 작업에 잘 작동하는 프롬프트
- 요청마다 한 가지 작업: 이미지에 대해 명확한 질문 하나를 하십시오. 한 프롬프트에 질문이 여러 개이면 답변이 짧아지고 덜 정확해집니다.
- 구조화된 출력: 영수증과 양식의 경우 원하는 필드를 이름으로 지정하십시오. 예:
item,price,total. JSON만 요청하십시오. - 읽을 수 없는 값: 값을 읽을 수 없을 때는
null을 쓰도록 모델에 지시하십시오. 그러면 모델이 추측하지 않습니다. - 먼저 자르기: 필요한 부분만 이미지에서 자르십시오. 작은 이미지는 토큰을 적게 쓰고 세부 정보가 더 좋습니다.
- 안정적인 답변: 추출 작업에는
temperature를 0으로 설정하십시오. - 숫자 확인: 합계와 날짜를 이미지와 비교하십시오. 비전 모델은 작은 글자와 비슷한 숫자를 잘못 읽을 수 있습니다.
문제 해결
| 문제 | 원인 | 해결 방법 |
|---|---|---|
오류 422 no_vision_model | 체인에 활성화된 비전 모델이 없음 | Fallback Chain 페이지에서 Vision 배지가 있는 모델을 활성화하십시오 |
| 모델이 이미지를 볼 수 없다고 말함 | 요청이 /v1/responses로 전송됨 | /v1/chat/completions를 사용하십시오 |
| 원격 URL에서 오류 400 | 제공업체가 URL을 다운로드할 수 없음 | 이미지를 base64 data URL로 보내십시오 |
| 큰 파일에서 오류 413 또는 400 | 이미지 또는 요청이 너무 큼 | 이미지를 줄이거나 보내는 이미지 수를 줄이십시오 |
| 이미지 요청에서 오류 429 | 이미지 토큰이 분당 토큰 한도를 사용함 | 이미지를 줄이거나, 더 많은 비전 제공업체의 키를 추가하십시오 |
자주 묻는 질문
무료 비전 API가 있습니까?
예. Google AI Studio, Groq, Cloudflare, NVIDIA, OpenRouter 및 기타 제공업체가 이미지 입력을 지원하는 무료 모델을 제공합니다. FreeLLMAPI는 하나의 OpenAI 호환 키 뒤에 무료 비전 모델 제공 항목 78개를 둡니다.
무료 LLM API에 이미지를 보내려면 어떻게 합니까?
사용자 메시지에 image_url 콘텐츠 블록을 추가하십시오. base64 data URL 또는 https URL을 사용하고, /v1/chat/completions로 보내십시오.
이미지는 토큰을 몇 개 사용합니까?
Gemini에서 384x384 픽셀 이하 이미지는 258 토큰을 사용합니다. 더 큰 이미지는 768x768 타일로 나뉘며, 타일마다 258 토큰을 사용합니다.
한 요청에 이미지를 여러 개 보낼 수 있습니까?
예. 메시지에 image_url 블록을 더 추가하십시오. 일부 제공업체는 개수를 제한합니다. 예를 들어 Groq는 Qwen 3.8 27B에서 요청당 이미지 3개를 허용합니다.
문서를 읽기에 가장 좋은 무료 비전 모델은 무엇입니까?
영수증, 차트, 스캔한 페이지에는 Gemini 모델을 사용하십시오. 컨텍스트 창이 크고 많은 이미지를 받습니다. 비전 모델은 작은 글자를 잘못 읽을 수 있으므로, 숫자는 이미지와 대조해 확인하십시오.
관련 가이드
출처
- FreeLLMAPI docs: Vision and image input (20 November 2026 확인)
- Google AI Studio docs: Image understanding (20 November 2026 확인)
- Groq docs: Vision (20 November 2026 확인)
- Moondream OpenAI-compatible API docs (20 November 2026 확인)