クリエイティブ
Beta

creative_upload_url_create

接続先のワークスペースにファイルを送るための署名付きアップロード URL を発行します。

操作 書き込み。読み取りと書き込みを許可した OAuth 接続が必要です。

パラメーター

パラメーター型必須説明
bodyオブジェクトはいファイルのメタデータ。
body.content_type文字列はいファイルの MIME タイプ。例は image/png。
body.size_bytes整数はい正確なバイト数。1 から 2,147,483,648 まで。
body.filename文字列いいえ元のファイル名。最大 255 文字。
idempotency_key文字列はいこのアップロードリクエストのキー。
approval_receipt文字列いいえプランの承認後に渡すレシート。

承認後、同じ入力と approval_receipt を送信します。15 分以内に、クライアントから data.upload_url にファイルのバイト列を PUT します。data.upload_headers は変更せずに付けます。署名付き URL が送信を認可するため、このリクエストに Orchestor の API キーを含めないでください。

PUT が成功したら、data.public_url を creative_generate_image の body.image_urls に指定します。参照画像を受け付けるモデルを選びます。読み取り用 URL は発行から 7 日間有効です。

依頼例

ローカルの product.png をアップロードして、新しい商品写真の参照画像にしてください。