LM Studioで画像が添付できない原因と解決策

最終更新日: 2026年11月03日

  • モデルが画像に対応していることを確認してください。
  • シンプルで互換性のあるファイルを試してみてください。
  • SDKまたは対応するエンドポイントスキーマを使用してください。
  • 内部チャットのJSONファイルを変更しないでください。
LM Studioでは画像の添付はできません

LM Studioで画像を添付できない場合、またはモデルが画像を受信して​​いないかのように反応する場合は、まずどのモデルを読み込んでいるかを確認してください。アプリケーションはビジョンモデルで動作しますが、 テキストのみをサポートするモデルは、ファイルを追加してもその機能を獲得することはできません。.

También conviene separar el fallo del chat de los problemas al enviar imágenes desde un script. La prueba más útil consiste en usar una imagen sencilla y comprobar cada vía por separado, antes de modificar configuraciones o reinstalar el programa.

アップロードされたモデルが画像をサポートしていることを確認してください。

LM Studioが画像をサポートしていることを確認してください。

写真、スクリーンショット、またはスキャンされた文書を解釈するには、 視覚言語モデル(VLMとも呼ばれる)名前が有名なファミリーに属しているだけでは十分ではありません。ダウンロードする前に、そのバージョンとその機能を確認してください。

  1. チャットで選択したモデルの正確な名前を確認してください。
  2. 画像入力に対応しているかどうか、仕様を確認してください。
  3. 別のモデルが必要な場合は、以下で探してください。 発見する そして、LM Studioと互換性のあるディストリビューションを選択してください。
  4. 画像をアップロードして、1枚の画像と、表示されるオブジェクトの説明といった簡単なリクエストで試してみてください。

内蔵の検索エンジンを使用すると、Hugging Face 上でモデルを名前またはリポジトリ アドレスで検索できます。Discover を開くには、 WindowsとLinuxではCtrl + 2、 どちらか MacではCmd + 2.

限定コンテンツ - ここをクリックしてください  Netflixアカウントに接続されたデバイスを表示および管理する方法

Si una descarga importada manualmente falla, compara primero el resultado con una distribución obtenida desde el buscador de la aplicación. Esto ayuda a separar un problema del paquete del modelo de un fallo en tu código.

ファイルをテストし、画像入力設定を確認してください。

診断テストとして、システムビューアで正しく開ける小さな画像を使用してください。サーバーイメージ入力のドキュメントに記載されているフォーマットは次のとおりです。 JPEG、PNG、WebP.

Si el archivo original utiliza otro formato, expórtalo realmente a PNG o JPEG. Cambiar únicamente la extensión no convierte su contenido.

Comprueba también qué significa exactamente el fallo:

  • 画像を選択または添付することはできません。 読み込んだモデルを確認し、新しいチャットで問題を再現してください。
  • 送信中にエラーが発生しました。 メッセージ全体を保存して、別のシンプルなファイルで試してみてください。
  • 画像は処理されているが、小さな文字が誤って解釈されている。 入力解像度を確認し、重要な領域を切り取ってみてください。

LM Studioには画像調整機能があります 設定 > チャット > 画像入力. La aplicación ha incorporado cambios tanto en el redimensionado como en el procesamiento visual, por lo que conviene comprobar las notas de versión si utilizas una instalación antigua.

Reducir dimensiones puede servir como prueba si falla una imagen grande, pero también puede perjudicar la lectura de letras pequeñas. Compara ambos resultados antes de establecer un límite permanente.

限定コンテンツ - ここをクリックしてください  Windows 11でユーザー名を正しく変更する方法

Pythonから内部チャットを編集せずに画像を送信する方法

画面上のプログラミングコードのクローズアップ。メタデータとJSONファイルの管理方法を示している。

分析を自動化するには、 公式Python SDKプロジェクト環境にインストールまたはアップデートできます。

python -m pip install --upgrade lmstudio

LM Studioが起動していて、ビジョンモデルがダウンロードされている状態で、この例ではファイルを準備し、それをメッセージに組み込みます。

from pathlib import Path
import lmstudio as lms

ruta = Path("imagen.png").resolve()

if not ruta.is_file():
    raise FileNotFoundError(f"No existe la imagen: {ruta}")

modelo = lms.llm("IDENTIFICADOR_DEL_MODELO_CON_VISION")
imagen = lms.prepare_image(str(ruta))

chat = lms.Chat()
chat.add_user_message(
    "Describe los elementos principales de esta imagen.",
    images=[imagen],
)

respuesta = modelo.respond(chat)
print(respuesta)

識別子をモデルの識別子に置き換え、指定されたパスに有効な画像を配置してください。この例では、まずファイルが存在するかどうかを確認し、場所のエラーと表示エラーを混同しないようにしています。

メッセージ本文にパスを記述しても、ファイルは添付されません。 このワークフローでは、画像は以下のように準備されます。 prepare_image() そして、議論を通して組み込まれる images.

Si aparece un error de conexión, revisa el host, el puerto y la autenticación de tu instalación antes de cambiar el archivo. La configuración del cliente debe corresponder al servidor al que quieres conectarte.

HTTPを使用している場合は、エンドポイントとそのスキームを確認してください。

モニター上に表示されたソースコードのマクロ。バイト列とデータURIの詳細な分析結果を示す。

ネイティブのLM Studio APIとOpenAI互換インターフェースは、異なる構造を使用しています。 彼らの分野を混ぜてはいけない dentro de una misma petición.

En POST /api/v1/chatエントリには、以下の構造を持つテキストブロックと画像ブロックを含めることができます。

{
  "model": "IDENTIFICADOR_DEL_MODELO_CON_VISION",
  "input": [
    {
      "type": "text",
      "content": "Describe esta imagen."
    },
    {
      "type": "image",
      "data_url": "data:image/png;base64,BASE64_REAL_DEL_ARCHIVO"
    }
  ]
}

この JSON はテンプレートです。識別子と base64 エンコーディングを置き換える必要があります。プレフィックスの MIME タイプは実際のファイルと一致する必要があります。このエンドポイントでは、 data_url contiene la URI de datos completa.

限定コンテンツ - ここをクリックしてください  iPhoneの設定から液体ガラス効果を削除する方法(迅速かつ永続的)

Para utilizar HTTP, activa el servidor desde la sección de desarrollo o con lms server startデフォルトのアドレスは http://localhost:1234; añade la autenticación correspondiente si la tienes habilitada.

Si tu aplicación utiliza /v1/chat/completionsそのインターフェースのスキーマを参照してください。上記のブロックはネイティブAPIに属するものであり、別のエンドポイントに合わせて調整せずにコピーしてはいけません。

一般的な解決策として、内部ファイルの変更は避けてください。

ノートパソコンとノートブックを備えた清潔な作業スペース。インストールおよびセットアップガイドの作成に最適です。

LM Studioは会話をJSON形式で保存し、チャットのコンテキストメニューからファイルを探すことができます。しかし、そのドキュメントは 手動で編集したり、その構造に頼ったりすることは推奨していません。.

Por eso, crear archivos en las carpetas internas o reconstruir sus metadatos no es una solución recomendable para un problema normal de adjuntos. Un procedimiento descubierto para una versión concreta puede dejar de funcionar con una actualización.

Para preparar una incidencia reproducible, anota la versión de LM Studio, el modelo exacto, el formato y dimensiones de la imagen, la vía utilizada y el error completo. Prueba con un archivo sin datos personales que puedas compartir. Esa comparación permite investigar el fallo sin alterar tus conversaciones guardadas.