Skip to main content

Integrasikan model pembuatan gambar

Panggil model pembuatan gambar Token Plan dari alat Agent, buat gambar dari deskripsi teks, dan unduh secara lokal.

Model yang didukung

ModelDeskripsi
qwen-image-3.0-proQwen Image Generation and Editing 3.0 Pro, mendukung text-to-image dan image-to-image
qwen-image-2.0-proQwen Image Generation 2.0 Pro (hanya Team Edition)
qwen-image-2.0Qwen Image Generation 2.0 (hanya Team Edition)
wan2.7-imagePembuatan gambar Wan
wan2.7-image-proPembuatan gambar Wan Pro
Untuk model lainnya, lihat model yang didukung Token Plan Personal Edition dan model yang didukung Token Plan Team Edition.

Prasyarat

  • Langganan Token Plan dan API key yang diawali dengan sk-sp-. Untuk detailnya, lihat Ikhtisar integrasi.
  • Alat coding AI Anda mendukung Slash Commands. Untuk jalur konfigurasi alat lainnya, lihat Alat lainnya.

Antarmuka

POST https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation Gunakan Authorization: Bearer $ANTHROPIC_AUTH_TOKEN di header permintaan. Untuk field request body dan response, lihat bagian di bawah ini.

Langkah 1: Buat Slash Command

Konfigurasikan kunci API Token Plan sebagai variabel lingkungan $ANTHROPIC_AUTH_TOKEN. Buat .claude/commands/text-to-image.md di root proyek dan tambahkan konten berikut:
Panggil API pembuatan gambar Token Plan untuk menghasilkan gambar dari deskripsi dan mengunduhnya secara lokal.

Deskripsi gambar: $ARGUMENTS

## Langkah

1. Ekstrak prompt (deskripsi gambar), model (default: qwen-image-3.0-pro), dan ukuran (default: 1024*1024) dari deskripsi. Jika deskripsi menentukan model, gunakan model tersebut.
2. Gunakan alat Bash untuk menjalankan perintah berikut:
```bash
curl -s -X POST "https://token-plan.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "input": {"messages": [{"role": "user", "content": [{"text": "<prompt>"}]}]},
    "parameters": {"size": "<size>"}
  }'
```
3. Ekstrak URL gambar dari `output.choices[0].message.content[0].image` dalam JSON respons.
4. Unduh gambar dengan `curl -s -o "generated_$(date +%Y%m%d_%H%M%S).png" "<URL>"`.
5. Tampilkan path file gambar yang dihasilkan.

Langkah 2: Hasilkan gambar

Di Claude Code, masukkan /text-to-image draw a cat. Untuk menggunakan model lain, tentukan model dalam perintah, misalnya /text-to-image use wan2.7-image to draw a cat.

Parameter permintaan

ParameterWajibDeskripsi
modelYaID model pembuatan gambar.
input.messages[0].content[0].textYaDeskripsi gambar.
parameters.sizeTidakUkuran gambar, misalnya 1024*1024. Jika dikosongkan, model akan memilih ukuran secara otomatis.
Untuk parameter lainnya, lihat API Pembuatan dan Pengeditan Gambar Qwen.

Respons

  • URL gambar: output.choices[0].message.content[0].image.
  • Penggunaan: usage.image_count, usage.width, usage.height.
  • URL gambar akan kedaluwarsa. Unduh gambar segera.

Batasan

  • Ukuran gambar dan model yang didukung bergantung pada dokumentasi masing-masing model.
  • Penagihan didasarkan pada jumlah gambar output. Konsumsi Credits aktual ditampilkan di Usage di konsol.

Alat lainnya

Untuk mekanisme ekstensi dan jalur konfigurasi alat lainnya, lihat Ikhtisar integrasi. Simpan Slash Command di atas ke jalur yang sesuai.