Api: Meneruskan media Anda sendiri

Berikan gambar, video, audio, dan dokumen Anda sendiri ke Morphic lewat URL, di kolom mana pun yang menerima media.

Setiap kolom yang menerima media (image_asset_id, reference_video_asset_ids, asset_id, dan setiap *_asset_id atau *_asset_ids lainnya) menerima id aset dari pustaka Anda atau URL HTTPS publik dari file tersebut. Anda bebas mencampur keduanya dalam satu panggilan. Tidak ada langkah unggah terpisah.

curl -s https://mcp.morphic.com/v1/direct/tools/edit_image \
  -H "Authorization: Bearer $MORPHIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "Put the bike on a beach at sunset", "image_asset_ids": ["https://cdn.example.com/products/bike.jpg"], "project_id": "01928f4e-…"}}'

Sebelum alat berjalan, setiap URL diambil dan ditambahkan ke project_id sebagai aset unggahan, tanpa biaya. Alat lalu memprosesnya seperti aset lainnya. URL membutuhkan cakupan assets:write, dan setiap URL yang berbeda dihitung sebagai satu panggilan terhadap kuota panggilan gratis.

URL harus HTTPS pada host publik dan menyajikan file itu sendiri, bukan halaman web.
Untuk file di penyimpanan Anda sendiri, berikan URL bertanda tangan (GET presigned S3, URL bertanda tangan GCS). Pastikan URL tetap berlaku hingga panggilan memberi respons.
Gambar, video, audio, dan dokumen (.pdf, .txt, .md, .srt) diterima. Byte file diperiksa, sehingga ekstensi tidak pernah dipercaya begitu saja.
Ukuran file media paling besar 100 MB, atau batas unggahan paket Anda jika lebih kecil, dan file harus tiba dalam 25 detik.
URL yang disebut dua kali dalam satu panggilan hanya diambil sekali. Panggilan berikutnya mengambilnya lagi; untuk memakai ulang file tanpa mengambilnya lagi, berikan id aset yang ditampilkan list_assets untuk file itu.
Input panggilan diperiksa terhadap skema alat sebelum URL apa pun diambil. Panggilan yang formatnya salah menghasilkan 400 invalid_request dan tidak mengambil apa pun.
URL yang tidak dapat diambil atau tidak diterima menghasilkan 422 tool_refused yang menyebutkan kolomnya, misalnya input.image_asset_ids[0]: The URL must use https. Tidak ada yang dimulai atau ditagih. File yang sudah ditambahkan tetap berada di proyek, sama seperti ketika alat itu sendiri menolak panggilan sesudahnya.
analyze_video dan analyze_audio menerima project_id hanya untuk keperluan ini: kirimkan saat kolom media berisi URL.
Langkah plan_media juga menerima URL, masing-masing ditambahkan ke project_id langkahnya, sehingga penawaran harga menambahkan file tersebut ke pustaka Anda. Berikan id aset yang kemudian ditampilkan list_assets ke langkah yang Anda jalankan, alih-alih URL-nya, agar setiap file hanya diambil sekali.

Jika Anda mengalami kendala atau memiliki pertanyaan, jangan ragu untuk menghubungi kami. Kami dengan senang hati akan membantu. Tulis kepada kami di support@morphic.com.