［開発者向け］xAI「Grok Imagine Quality Mode」API解説——高リアリズム画像生成と編集機能の実装ガイド

pip install xai-sdk

# APIキーを環境変数として設定します（Mac/Linux）
export XAI_API_KEY="your-api-key-here"

import xai_sdk

# xAI SDKのクライアントを初期化します
client = xai_sdk.Client()

# 画像を生成します。modelにQuality Modeのモデル名を指定します
response = client.image.sample(
    prompt="A collage of London landmarks in a stenciled street-art style",
    model="grok-imagine-image-quality",  # 旧モデル名(grok-imagine-image-pro)からの変更点
)

# 生成された画像の一時URLを出力します
print(response.url)

import base64
import xai_sdk

client = xai_sdk.Client()

# ローカルファイルをbase64エンコードして読み込みます
with open("photo.png", "rb") as f:
    image_data = base64.b64encode(f.read()).decode("utf-8")

# 元画像と編集内容を指定して画像を生成します
response = client.image.sample(
    prompt="Render this as a pencil sketch with detailed shading",
    model="grok-imagine-image",
    image_url=f"data:image/png;base64,{image_data}",  # base64データURIとして渡します
)

print(response.url)

import xai_sdk

client = xai_sdk.Client()

# 複数の参照画像URLを指定して合成します
response = client.image.sample(
    prompt="Show all subjects sitting together on the grass in a sunny park. Casual relaxed mood, natural daylight.",
    model="grok-imagine-image",
    image_urls=[
        "https://example.com/person1.jpg",  # 1枚目の参照画像URL
        "https://example.com/person2.jpg",  # 2枚目の参照画像URL
    ],
    aspect_ratio="3:2",  # 出力画像のアスペクト比を指定します（省略時は1枚目の画像に合わせて自動選択）
)

print(response.url)

import xai_sdk

client = xai_sdk.Client()

# Step 1: ベース画像を生成します
response_1 = client.image.sample(
    prompt="A modern living room with large windows overlooking the city",
    model="grok-imagine-image",
)

print(f"Step 1: {response_1.url}")

# Step 2: Step 1の出力を入力として家具を変更します
response_2 = client.image.sample(
    prompt="Replace the sofa with a minimalist leather couch",
    model="grok-imagine-image",
    image_url=response_1.url,  # 前のステップの出力URLをそのまま渡します
)

print(f"Step 2: {response_2.url}")

import asyncio
import xai_sdk

async def generate_concurrently():
    # 非同期クライアントを初期化します
    client = xai_sdk.AsyncClient()
    source_image = "https://example.com/photo.jpg"

    # 異なるスタイルを並行処理するためのプロンプトリストです
    prompts = [
        "Render this image as an oil painting in the style of impressionism",
        "Render this image as a pencil sketch with detailed shading",
        "Render this image as pop art with bold colors and halftone dots",
    ]

    # すべてのリクエストを同時に送信します（直列処理より大幅に高速）
    tasks = [
        client.image.sample(
            prompt=prompt,
            model="grok-imagine-image",
            image_url=source_image,
        )
        for prompt in prompts
    ]
    results = await asyncio.gather(*tasks)

    for prompt, result in zip(prompts, results):
        print(f"{prompt[:30]}...: {result.url}")

# 非同期関数を実行します
asyncio.run(generate_concurrently())

import xai_sdk

client = xai_sdk.Client()

# 同一プロンプトから4枚のバリエーションを一度のリクエストで生成します
responses = client.image.sample_batch(
    prompt="A futuristic city skyline at night",
    model="grok-imagine-image",
    n=4,  # 生成枚数（最大10枚）
)

for i, image in enumerate(responses):
    print(f"Variation {i + 1}: {image.url}")

# 2K解像度で生成します
response = client.image.sample(
    prompt="An astronaut performing EVA in LEO.",
    model="grok-imagine-image",
    resolution="2k",  # "1k" または "2k" を指定します
)

# URLではなくbase64データとして画像を取得します
response = client.image.sample(
    prompt="A serene Japanese garden",
    model="grok-imagine-image",
    image_format="base64",
)

# ファイルにそのまま保存します
with open("garden.jpg", "wb") as f:
    f.write(response.image)

# 生成画像がモデレーションを通過したかを確認します
if response.respect_moderation:
    print(response.url)

else:
    print("この画像はコンテンツポリシーによりフィルタリングされました")