멀티모달 입력

일부 모델은 메시지에 이미지를 함께 받습니다. 형식은 표준 OpenAI content parts 배열이므로, OpenAI 호환 엔드포인트에 이미지를 보낼 수 있는 클라이언트라면 그대로 우리에게 보낼 수 있습니다.

우리가 지원하는 추가 모달리티는 이미지 입력 하나입니다. 이미지·영상·오디오·음성 출력은 없습니다 — 해당 경로는 404 not_supported 입니다. 지원하지 않는 엔드포인트 를 보세요.

어떤 모델이 이미지를 받는가

architecture.input_modalities 에 "image" 가 들어 있는 모델뿐입니다. 짐작하지 말고 카탈로그에 물어보세요.

curl "https://openrouter.myip.co.kr/api/v1/models?input_modalities=text,image"

현재는 기본 모델이자 우리 GPU 에서 돌아가는 google/gemma-4-26b-a4b 입니다. lgai/exaone-4.0-32b 는 텍스트 전용이라 이미지 파트를 보내도 동작하지 않습니다.

메시지 형식

문자열 content 대신 파트 배열을 넣습니다. 각 파트는 {"type": "text", …} 또는 {"type": "image_url", …} 입니다.

{
  "model": "google/gemma-4-26b-a4b",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "이 이미지에서 보이는 것을 한국어로 설명해 줘." },
        { "type": "image_url", "image_url": { "url": "https://example.com/photo.jpg" } }
      ]
    }
  ]
}

url 에는 공개 HTTPS URL 또는 base64 를 담은 data: URI 를 넣습니다. data URI 쪽이 안전합니다 — 모델 호스트가 여러분 서버에 접근할 수 있어야 할 필요가 없고, 이미지 URL 이 어딘가로 새지도 않습니다.

data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA…

한 메시지에 이미지를 여러 장 넣을 수도 있습니다. image_url 파트를 여러 개 두면 되고, 전체 프롬프트가 모델의 컨텍스트 창에 들어가기만 하면 됩니다.

예제

IMAGE_B64=$(base64 -w0 photo.jpg)

curl https://openrouter.myip.co.kr/api/v1/chat/completions \
  -H "Authorization: Bearer $MYIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<JSON
{
  "model": "google/gemma-4-26b-a4b",
  "messages": [{
    "role": "user",
    "content": [
      { "type": "text", "text": "이 사진을 한 문장으로 설명해 줘." },
      { "type": "image_url", "image_url": { "url": "data:image/jpeg;base64,$IMAGE_B64" } }
    ]
  }]
}
JSON

이미지 과금

이미지는 모델의 프로세서가 토큰으로 바꾸고, 그 토큰은 usage.prompt_tokens 에 실려 옵니다. 우리는 그것을 모델의 일반 입력 단가로 청구합니다 — google/gemma-4-26b-a4b 는 ₩30 / 1M 토큰입니다. 이미지당 별도 요금은 없습니다. 카탈로그의 pricing.image 가 언제나 "0" 인 것은 그런 과금 항목 자체가 없기 때문입니다.

현실적인 결론은 이렇습니다. 이미지는 공짜도 아니고 싸지도 않습니다. 고해상도 사진 한 장이 수백 프롬프트 토큰이 될 수 있습니다. 디테일이 필요 없다면 미리 줄여서 보내세요.

지원하지 않는 것

이미지를 넣어 프롬프트가 너무 커져도 대신 줄여 주는 장치는 없습니다. 컨텍스트 창에 직접 맞추는 방법은 메시지 변환 에 있습니다.