タスク、参照素材、結果

​

一度だけ送信し、タスク ID を控える

​

タイムアウトや結果不明から復旧する

​

参照素材をモデルが読めるようにする

1. 受け付けられる画像・動画・音声の種類、数、サイズ、参照素材の組み合わせを確認します。
2. 実行環境で読み取れるファイル、またはサーバーからアクセスできる URL を使います。チャットの添付ファイルやデスクトップ上のパスが、そのままリモートから読み取れるわけではありません。
3. アップロードのレシートとファイル URL を確認してから、それをモデルの入力に追加し、もう一度見積もります。
4. 結果が不明な場合は、元の upload_id を保持してください。代わりのアップロードを要求するのは、失敗または失効が確定してからにします。レシートに対応しているかどうかは、デプロイ環境によって異なります。

​

有効期限と保存

​

ダウンロードとプレビューのトラブルシューティング

1. 元のタスクを照会し、完了していることを確認します。そのタスクのオリジナルの URL を使ってください。失効したリンク、非公開のリンク、無効なリンクは、ヘッダーを付けても直せません。
2. CLI の場合は download を使えます。MCP の場合は、オリジナルファイルをブラウザで開くか、ファイルを扱える環境から保存できます。CLI でのダウンロードと MCP での受け渡しを参照してください。
3. HTTP ステータス、Content-Type、実際の形式を確認します。エラーの HTML や JSON はメディアではありません。すべての画像を PNG という名前に変えるのではなく、拡張子を実際の形式に合わせてください。
4. プレビューがグレーになっている場合や、リンクしか表示されない場合は、オリジナルファイルを開いてください。問題なく開ければ、それを渡すか保存します。ホストのプレビューを理由に、承認のない再生成や編集を行ってはいけません。

​

Python のデフォルトのリクエストが拒否される場合

from urllib.request import Request, urlopen
from shutil import copyfileobj

request = Request(result_url, headers={"User-Agent": "EvoLinkClient/1.0"})
with urlopen(request, timeout=60) as response:
    if not response.headers.get_content_type().startswith("image/"):
        raise ValueError("Expected an image response")
    with open("result.png", "xb") as output:
        copyfileobj(response, output)

​

サポートに伝える情報