Image 提供： Clarity

Clarity Upscaler API

創造的な「hi-res fix」アップスケーラー。好みに合わせてディテールを補完。

Clarity Upscaler を1回のAPIコールで統合できます。1つのキー、1つの統一エンドポイント、そしてApiframe上のすべてのモデルで共通の請求。

APIキーを取得 Apiframe Studioで使う Clarity Upscaler APIドキュメントを見る

model: "clarity-upscale"

Clarity Upscaler の特長

画像から画像への編集と参照画像に対応。
高速処理 — 1回の生成あたり平均約13秒。
Clarity のアカウント不要の従量課金。成功した生成分だけお支払いいただきます。
Apiframe のすべてのモデルで、1つのAPIキー・統一請求・冪等性・Webhookに対応。

Clarity Upscaler で作成

Apiframeの Clarity Upscaler API で生成した出力例です。

サンプル準備中

概要

エンドポイント: POST /v2/images/upscale
モデルID: clarity-upscale
パラメータキー: clarityUpscaleParams
モダリティ: 画像
プロバイダー: Clarity
平均完了時間: ~13s

機能

画像入力対応

平均時間~13秒

クイックスタート

APIキーを添えて POST /v2/images/upscale に1回リクエストを送るだけで Clarity Upscaler による生成が始まります。レスポンスには、ポーリングまたはWebhookで受け取れる jobId が返ります。

curl -X POST https://api.apiframe.ai/v2/images/upscale \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "model": "clarity-upscale",
        "clarityUpscaleParams": {
            "image": "https://example.com/input.jpg",
            "prompt": "Optional — describe the kind of detail to add",
            "scale_factor": "2",
            "creativity": 0.35
        }
    }'

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/images/upscale",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "model": "clarity-upscale",
        "clarityUpscaleParams": {
            "image": "https://example.com/input.jpg",
            "prompt": "Optional — describe the kind of detail to add",
            "scale_factor": "2",
            "creativity": 0.35
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

const response = await fetch("https://api.apiframe.ai/v2/images/upscale", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "clarity-upscale",
    "clarityUpscaleParams": {
      "image": "https://example.com/input.jpg",
      "prompt": "Optional — describe the kind of detail to add",
      "scale_factor": "2",
      "creativity": 0.35
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

レスポンスとジョブのライフサイクル

生成は非同期で行われます。送信が成功すると 202 Accepted と jobId が返ります。ステータスが COMPLETED になるまで GET /v2/jobs/{id} をポーリングする（または webhook_url を指定する）と、result フィールドに出力URLが格納されます。

1. 送信レスポンス (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. 結果をポーリング

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

入力スキーマ

Clarity Upscaler エンドポイントが受け付けるリクエストパラメータです。モデル固有のオプションは、下記のパラメータオブジェクトの中にネストされます。

パラメータ	型	必須	デフォルト	許可値 / 範囲	説明
model	string	必須	"clarity-upscale"	"clarity-upscale"	このエンドポイントのモデル識別子。
clarityUpscaleParams.image	string (URL)	任意	—	—	Source image (URL)
clarityUpscaleParams.prompt	string	任意	—	—	Steering prompt
clarityUpscaleParams.scale_factor	string	任意	"2"	"1", "2", "4", "8"	Scale factor
clarityUpscaleParams.creativity	number	任意	0.35	min 0, max 1, step 0.05	How much new detail Clarity is allowed to invent.
clarityUpscaleParams.resemblance	number	任意	0.6	min 0, max 3, step 0.05	How tightly to stick to the input.
clarityUpscaleParams.dynamic	number	任意	6	min 1, max 50, step 1	HDR / dynamic range
clarityUpscaleParams.num_inference_steps	number	任意	18	min 1, max 100, step 1	Steps
clarityUpscaleParams.output_format	string	任意	"png"	"png", "jpg", "webp"	Output format
clarityUpscaleParams.seed	number	任意	—	step 1	Reuse a number to reproduce the same result.

よくある質問

Clarity Upscaler APIに関するよくある質問をまとめました。

Clarity Upscaler の API はありますか？

はい。Apiframe は単一の REST エンドポイント（`POST /v2/images/upscale`、`model: "clarity-upscale"`）で Clarity Upscaler を提供します。対応するすべてのモデルで、統一されたAPI・キー・請求をご利用いただけ、Clarity の個別アカウントは不要です。

Clarity Upscaler API の料金はいくらですか？

Clarity Upscaler は Apiframe のシンプルな従量課金制で、成功した生成分のみお支払いいただきます。プランと数量割引は料金ページをご覧ください。

Clarity Upscaler API はどのように呼び出しますか？

`X-API-Key` と、`model: "clarity-upscale"` を含む JSON ボディを添えて `/v2/images/upscale` に POST リクエストを送ります。レスポンスで返る `jobId` を `GET /v2/jobs/{id}` でポーリングするか、Webhook で結果を受け取ります。

Clarity Upscaler はどんなパラメータに対応していますか？

Clarity Upscaler は、共通の `prompt`・`webhook_url` に加えて、`clarityUpscaleParams` の下にネストされた 9 個のモデル固有パラメータを受け付けます。型やデフォルト値を含む一覧は上記の入力スキーマをご覧ください。

解決しませんでしたか？

サポートに問い合わせる Discordに参加