ファイルアップロード

Atlas Cloud にローカルファイルをアップロードして、画像から動画への変換、画像編集などのワークフローに使用

概要

多くの AI 生成ワークフローでは入力ファイルが必要です。たとえば、静止画を動画にアニメーション化する、スタイル転送を適用する、既存の画像を編集するなどです。メディアアップロード エンドポイントを使用すると、ローカルファイルを Atlas Cloud にアップロードし、生成エンドポイントに渡せる一時 URL を取得できます。

API エンドポイント

POST https://api.atlascloud.ai/api/v1/model/uploadMedia

認証

Authorization ヘッダーに API キーを含めてください:

Authorization: Bearer your-api-key

リクエスト

file フィールドにファイルを含む multipart/form-data リクエストとして送信します。

レスポンス

アップロードされたファイルの一時 URL を含む JSON オブジェクトを返します。

コード例

Python

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/uploadMedia",
    headers={"Authorization": "Bearer your-api-key"},
    files={"file": open("photo.jpg", "rb")}
)

data = response.json()
file_url = data.get("url")
print(f"Uploaded file URL: {file_url}")

Node.js

import fs from "fs";

const formData = new FormData();
formData.append("file", new Blob([fs.readFileSync("photo.jpg")]));

const response = await fetch(
  "https://api.atlascloud.ai/api/v1/model/uploadMedia",
  {
    method: "POST",
    headers: { Authorization: "Bearer your-api-key" },
    body: formData,
  }
);

const { url } = await response.json();
console.log(`Uploaded file URL: ${url}`);

cURL

curl -X POST https://api.atlascloud.ai/api/v1/model/uploadMedia \
  -H "Authorization: Bearer your-api-key" \
  -F "[email protected]"

一般的なワークフロー

画像から動画へ

ソース画像をアップロードし、その URL を動画生成モデルに渡します:

import requests

# ステップ 1: 画像をアップロード
upload_resp = requests.post(
    "https://api.atlascloud.ai/api/v1/model/uploadMedia",
    headers={"Authorization": "Bearer your-api-key"},
    files={"file": open("my_image.jpg", "rb")}
)
image_url = upload_resp.json().get("url")

# ステップ 2: アップロードした画像から動画を生成
video_resp = requests.post(
    "https://api.atlascloud.ai/api/v1/model/generateVideo",
    headers={
        "Authorization": "Bearer your-api-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "kling-v2.0",
        "prompt": "The person slowly turns and smiles",
        "image_url": image_url
    }
)

prediction_id = video_resp.json()["data"]["id"]
print(f"Video generation started: {prediction_id}")

画像から画像へ（スタイル転送、高画質化）

import requests

# ステップ 1: ソース画像をアップロード
upload_resp = requests.post(
    "https://api.atlascloud.ai/api/v1/model/uploadMedia",
    headers={"Authorization": "Bearer your-api-key"},
    files={"file": open("source.jpg", "rb")}
)
image_url = upload_resp.json().get("url")

# ステップ 2: 変換を適用
result = requests.post(
    "https://api.atlascloud.ai/api/v1/model/generateImage",
    headers={
        "Authorization": "Bearer your-api-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "your-image-to-image-model",
        "image_url": image_url,
        "prompt": "Transform into oil painting style"
    }
)

重要な注意事項

一時的な URL: アップロードされたファイルは Atlas Cloud の生成タスクでの一時的な使用のみを目的としています。ファイルは定期的にクリーンアップされる場合があります。
対応フォーマット: 一般的な画像フォーマット（JPEG、PNG、WebP）および動画フォーマットがサポートされています。フォーマット要件については、各モデルのドキュメントをご確認ください。
ファイルサイズ: モデルによってアップロードファイルサイズに制限がある場合があります。具体的な制限については、モデルの詳細ページをご参照ください。
速やかに使用: アップロードしたファイルの URL は同じセッション内で使用してください。長期保存には依存しないでください。

次のステップ

予測 — 非同期生成タスクのステータスと結果の追跡
画像生成 — 画像生成モデルを探索
動画生成 — 動画生成モデルを探索
API リファレンス — 完全な API 仕様

目次