자체 미디어 전달하기

미디어를 받는 모든 필드(image_asset_id, reference_video_asset_ids, asset_id, 그 밖의 모든 *_asset_id 또는 *_asset_ids)는 라이브러리의 에셋 ID나 파일의 공개 HTTPS URL을 받습니다. 한 번의 호출에서 둘을 자유롭게 섞어 쓸 수 있습니다. 별도의 업로드 단계는 없습니다.

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

도구가 실행되기 전에 각 URL을 가져와 업로드된 에셋으로 project_id에 무료로 추가합니다. 그런 다음 도구는 다른 에셋과 똑같이 이를 처리합니다. URL에는 assets:write 범위가 필요하며, 서로 다른 URL마다 무료 호출 버킷에서 호출 한 번으로 계산됩니다.

• URL은 공개 호스트의 HTTPS여야 하며, 웹 페이지가 아니라 파일 자체를 제공해야 합니다.
• 자체 스토리지에 있는 파일은 서명된 URL(S3 사전 서명 GET, GCS 서명된 URL)을 전달하세요. 호출이 응답할 때까지 유효하게 유지해야 합니다.
• 이미지, 동영상, 오디오, 문서(.pdf, .txt, .md, .srt)를 받습니다. 바이트를 직접 검사하므로 확장자는 신뢰하지 않습니다.
• 미디어 파일은 최대 100MB(요금제의 업로드 한도가 더 낮으면 그 한도)까지 가능하며, 25초 안에 도착해야 합니다.
• 한 호출에서 두 번 지정된 URL은 한 번만 가져옵니다. 이후 호출에서는 다시 가져옵니다. 다시 가져오지 않고 파일을 재사용하려면 list_assets에 표시되는 해당 파일의 에셋 ID를 전달하세요.
• 호출 입력은 URL을 가져오기 전에 도구의 스키마로 검증됩니다. 형식이 잘못된 호출은 400 invalid_request를 반환하며 아무것도 가져오지 않습니다.
• 가져올 수 없거나 허용되지 않는 URL은 필드를 명시한 422 tool_refused를 반환합니다. 예: input.image_asset_ids[0]: The URL must use https. 아무것도 시작되거나 청구되지 않습니다. 이미 추가된 파일은 도구 자체가 이후에 호출을 거부할 때와 마찬가지로 프로젝트에 남습니다.
• analyze_video와 analyze_audio는 이 용도로만 project_id를 받습니다. 미디어 필드에 URL이 있을 때 보내세요.
• plan_media 단계도 URL을 받으며, 각 URL은 해당 단계의 project_id에 추가되므로, 견적을 내면 해당 파일이 라이브러리에 추가됩니다. 실행하는 단계에는 URL 대신 그 후 list_assets에 표시되는 에셋 ID를 전달해 각 파일을 한 번만 가져오세요.

문제가 있거나 궁금한 점이 있으면 언제든지 연락해 주세요. 기꺼이 도와드리겠습니다. 다음 주소로 이메일을 보내 주세요: support@morphic.com.