Api: Como passar sua própria mídia

Passe ao Morphic suas próprias imagens, vídeos, áudios e documentos por URL, em qualquer campo que receba mídia.

Todo campo que recebe mídia (image_asset_id, reference_video_asset_ids, asset_id e qualquer outro *_asset_id ou *_asset_ids) aceita um ID de recurso da sua biblioteca ou uma URL HTTPS pública do arquivo. Combine os dois livremente na mesma chamada. Não há uma etapa de envio separada.

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

Antes de a ferramenta ser executada, cada URL é baixada e adicionada a project_id como um recurso enviado, sem custo. A ferramenta então trabalha com ele como com qualquer outro recurso. Uma URL exige o escopo assets:write, e cada URL distinta conta como uma chamada na cota de chamadas gratuitas.

A URL deve ser HTTPS em um host público e servir o próprio arquivo, não uma página da web.
Para um arquivo no seu próprio armazenamento, passe uma URL assinada (um GET pré-assinado do S3, uma URL assinada do GCS). Mantenha-a válida até a chamada responder.
São aceitos imagens, vídeos, áudios e documentos (.pdf, .txt, .md, .srt). Os bytes são analisados, então a extensão nunca é levada em conta.
Um arquivo de mídia pode ter até 100 MB, ou o limite de envio do seu plano quando ele for menor, e precisa chegar em até 25 segundos.
Uma URL citada duas vezes na mesma chamada é baixada uma vez. Uma chamada posterior a baixa de novo; para reutilizar um arquivo sem baixá-lo novamente, passe o ID de recurso que list_assets mostra para ele.
A entrada da chamada é validada contra o schema da ferramenta antes de qualquer URL ser baixada. Uma chamada malformada responde 400 invalid_request e não baixa nada.
Uma URL que não pode ser baixada ou não é aceita responde 422 tool_refused indicando o campo, por exemplo input.image_asset_ids[0]: The URL must use https. Nada é iniciado nem cobrado. Um arquivo já adicionado permanece no projeto, como acontece quando a própria ferramenta recusa a chamada depois.
analyze_video e analyze_audio recebem project_id apenas para isso: envie-o quando um campo de mídia contiver uma URL.
As etapas de plan_media também aceitam URLs, cada uma adicionada ao project_id da sua etapa, de modo que um orçamento adiciona esses arquivos à sua biblioteca. Passe às etapas que você executar os IDs de recurso que list_assets mostra em seguida, em vez das URLs, para baixar cada arquivo uma única vez.

Se você tiver algum problema ou alguma dúvida, entre em contato. Teremos prazer em ajudar. Escreva para nós em support@morphic.com.