Api: Kendi medyanızı iletme

Kendi görsellerinizi, videolarınızı, seslerinizi ve belgelerinizi, medya alan herhangi bir alanda URL ile Morphic'e iletin.

Medya alan her alan (image_asset_id, reference_video_asset_ids, asset_id ve diğer tüm *_asset_id veya *_asset_ids alanları), kütüphanenizdeki bir varlık kimliğini ya da dosyanın herkese açık bir HTTPS URL'sini kabul eder. İkisini tek bir çağrıda serbestçe karıştırabilirsiniz. Ayrı bir yükleme adımı yoktur.

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-…"}}'

Araç çalışmadan önce her URL getirilir ve yüklenmiş bir varlık olarak project_id içine ücretsiz eklenir. Araç daha sonra onu diğer varlıklar gibi işler. Bir URL assets:write kapsamını gerektirir ve her farklı URL, ücretsiz çağrı kotasına bir çağrı olarak sayılır.

URL, herkese açık bir ana bilgisayarda HTTPS olmalı ve bir web sayfası değil, dosyanın kendisini sunmalıdır.
Kendi depolama alanınızdaki bir dosya için imzalı bir URL (S3 önceden imzalı GET, GCS imzalı URL) iletin. Çağrı yanıt verene kadar geçerli kalmasını sağlayın.
Görseller, video, ses ve belgeler (.pdf, .txt, .md, .srt) kabul edilir. Baytlar incelenir, bu yüzden dosya uzantısına hiçbir zaman güvenilmez.
Bir medya dosyası en fazla 100 MB olabilir (planınızın yükleme sınırı daha düşükse o sınır) ve 25 saniye içinde ulaşmalıdır.
Tek bir çağrıda iki kez geçen bir URL bir kez getirilir. Sonraki bir çağrı onu yeniden getirir; bir dosyayı yeniden getirmeden tekrar kullanmak için list_assets aracının onun için gösterdiği varlık kimliğini iletin.
Çağrının girdisi, herhangi bir URL getirilmeden önce aracın şemasına göre denetlenir. Hatalı biçimlendirilmiş bir çağrı 400 invalid_request yanıtını döndürür ve hiçbir şey getirmez.
Getirilemeyen veya kabul edilmeyen bir URL, alanı belirten 422 tool_refused yanıtını döndürür; örneğin input.image_asset_ids[0]: The URL must use https. Hiçbir şey başlatılmaz veya ücretlendirilmez. Zaten eklenmiş bir dosya, aracın kendisi çağrıyı sonradan reddettiğinde olduğu gibi projede kalır.
analyze_video ve analyze_audio, project_id değerini yalnızca bunun için alır: bir medya alanında URL olduğunda gönderin.
plan_media adımları da URL kabul eder; her biri kendi adımının project_id değerine eklenir; bu nedenle bir fiyat teklifi bu dosyaları kütüphanenize ekler. Her dosyayı bir kez getirmek için çalıştırdığınız adımlara URL'ler yerine list_assets aracının ardından gösterdiği varlık kimliklerini iletin.

Herhangi bir sorun yaşarsanız ya da sorularınız olursa, bizimle iletişime geçmekten çekinmeyin. Yardım etmeye memnuniyet duyarız. Bize şu adresten yazın: support@morphic.com.