
Qwen-Image Text-to-Image Plus API by Alibaba
General-purpose image generation model that supports various art styles and is particularly good at rendering complex text.
INPUT
OUTPUT
MenungguPermintaan Anda akan dikenakan biaya $0.021 per eksekusi. Dengan $10 Anda dapat menjalankan model ini sekitar 476 kali.
Berikut yang dapat Anda lakukan selanjutnya:
Contoh kode
import requests
import time
# Step 1: Start image generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "alibaba/qwen-image/text-to-image-plus",
"prompt": "A beautiful landscape with mountains and lake",
"width": 512,
"height": 512,
"steps": 20,
"guidance_scale": 7.5,
}
generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]
# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
def check_status():
while True:
response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
result = response.json()
if result["data"]["status"] == "completed":
print("Generated image:", result["data"]["outputs"][0])
return result["data"]["outputs"][0]
elif result["data"]["status"] == "failed":
raise Exception(result["data"]["error"] or "Generation failed")
else:
# Still processing, wait 2 seconds
time.sleep(2)
image_url = check_status()Instalasi
Instal paket yang diperlukan untuk bahasa pemrograman Anda.
pip install requestsAutentikasi
Semua permintaan API memerlukan autentikasi melalui API key. Anda bisa mendapatkan API key dari dasbor Atlas Cloud.
export ATLASCLOUD_API_KEY="your-api-key-here"HTTP Headers
import os
API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}Jangan pernah mengekspos API key Anda di kode sisi klien atau repositori publik. Gunakan variabel lingkungan atau proxy backend sebagai gantinya.
Kirim permintaan
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "your-model",
"prompt": "A beautiful landscape"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())Kirim Permintaan
Kirim permintaan pembuatan asinkron. API mengembalikan prediction ID yang dapat Anda gunakan untuk memeriksa status dan mengambil hasil.
/api/v1/model/generateImageIsi Permintaan
import requests
url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
"model": "alibaba/qwen-image/text-to-image-plus",
"input": {
"prompt": "A beautiful landscape with mountains and lake"
}
}
response = requests.post(url, headers=headers, json=data)
result = response.json()
print(f"Prediction ID: {result['id']}")
print(f"Status: {result['status']}")Respons
{
"id": "pred_abc123",
"status": "processing",
"model": "model-name",
"created_at": "2025-01-01T00:00:00Z"
}Periksa Status
Polling prediction endpoint untuk memeriksa status permintaan Anda saat ini.
/api/v1/model/prediction/{prediction_id}Contoh Polling
import requests
import time
prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
while True:
response = requests.get(url, headers=headers)
result = response.json()
status = result["data"]["status"]
print(f"Status: {status}")
if status in ["completed", "succeeded"]:
output_url = result["data"]["outputs"][0]
print(f"Output URL: {output_url}")
break
elif status == "failed":
print(f"Error: {result['data'].get('error', 'Unknown')}")
break
time.sleep(3)Nilai Status
processingPermintaan masih diproses.completedPembuatan selesai. Output tersedia.succeededPembuatan berhasil. Output tersedia.failedPembuatan gagal. Periksa field error.Respons Selesai
{
"data": {
"id": "pred_abc123",
"status": "completed",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.png"
],
"metrics": {
"predict_time": 8.3
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}
}Unggah File
Unggah file ke penyimpanan Atlas Cloud dan dapatkan URL yang dapat Anda gunakan dalam permintaan API Anda. Gunakan multipart/form-data untuk mengunggah.
/api/v1/model/uploadMediaContoh Unggah
import requests
url = "https://api.atlascloud.ai/api/v1/model/uploadMedia"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }
with open("image.png", "rb") as f:
files = {"file": ("image.png", f, "image/png")}
response = requests.post(url, headers=headers, files=files)
result = response.json()
download_url = result["data"]["download_url"]
print(f"File URL: {download_url}")Respons
{
"data": {
"download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
"file_name": "image.png",
"content_type": "image/png",
"size": 1024000
}
}Input Schema
Parameter berikut diterima di isi permintaan.
Tidak ada parameter yang tersedia.
Contoh Isi Permintaan
{
"model": "alibaba/qwen-image/text-to-image-plus"
}Output Schema
API mengembalikan respons prediction dengan URL output yang dihasilkan.
Contoh Respons
{
"id": "pred_abc123",
"status": "completed",
"model": "model-name",
"outputs": [
"https://storage.atlascloud.ai/outputs/result.png"
],
"metrics": {
"predict_time": 8.3
},
"created_at": "2025-01-01T00:00:00Z",
"completed_at": "2025-01-01T00:00:10Z"
}Atlas Cloud Skills
Atlas Cloud Skills mengintegrasikan 300+ model AI langsung ke asisten pengkodean AI Anda. Satu perintah untuk menginstal, lalu gunakan bahasa alami untuk menghasilkan gambar, video, dan mengobrol dengan LLM.
Klien yang Didukung
Instalasi
npx skills add AtlasCloudAI/atlas-cloud-skillsAtur API Key
Dapatkan API key dari dasbor Atlas Cloud dan atur sebagai variabel lingkungan.
export ATLASCLOUD_API_KEY="your-api-key-here"Kemampuan
Setelah diinstal, Anda dapat menggunakan bahasa alami di asisten AI Anda untuk mengakses semua model Atlas Cloud.
MCP Server
Atlas Cloud MCP Server menghubungkan IDE Anda dengan 300+ model AI melalui Model Context Protocol. Berfungsi dengan klien apa pun yang kompatibel dengan MCP.
Klien yang Didukung
Instalasi
npx -y atlascloud-mcpKonfigurasi
Tambahkan konfigurasi berikut ke file pengaturan MCP di IDE Anda.
{
"mcpServers": {
"atlascloud": {
"command": "npx",
"args": [
"-y",
"atlascloud-mcp"
],
"env": {
"ATLASCLOUD_API_KEY": "your-api-key-here"
}
}
}
}Alat yang Tersedia
Schema API
Schema tidak tersediaTidak ada contoh yang tersedia
Silakan masuk untuk melihat riwayat permintaan
Anda perlu masuk untuk mengakses riwayat permintaan model Anda.
MasukAlibaba Qwen-Image Text-to-Image Plus
An enhanced text-to-image generation model from Alibaba Cloud that strikes an optimal balance between high-quality visual output and generation efficiency. Qwen-Image Plus is designed to handle a wide variety of creative tasks, producing detailed and aesthetically pleasing images from text prompts with excellent semantic understanding.
Overview
- Purpose: Generate high-quality images from text descriptions efficiently.
- Core Capability: Strong prompt adherence and versatile style generation.
- Foundation: Powered by Alibaba's advanced multi-modal generative AI technology.
- Typical Output: Detailed, coherent images suitable for content creation, social media, and design drafts.
- Use Cases: Social media content, blog illustrations, rapid prototyping, storyboarding, and general creative design.
Key Features
- Enhanced Visual Quality: Produces sharp, vibrant, and well-composed images that exceed standard model capabilities.
- Semantic Accuracy: Effectively understands and visualizes complex prompts and descriptive attributes.
- Balanced Performance: Optimized to deliver high-quality results with faster generation times compared to the Max variant.
- Style Adaptability: Capable of generating images in various artistic styles, including anime, photorealism, sketch, and digital art.
- Text Rendering: Good capability for rendering text elements within images.
Designed For
- Content Creators: Quickly generate engaging visuals for social platforms and articles.
- Developers: Integrate reliable image generation into applications and workflows.
- Designers: Rapidly iterate on concepts and create mood boards.
- General Users: Explore AI art generation with high-quality results.
Input Requirements
To achieve the best results, follow these guidelines:
Text Prompt
- Content: Clear and descriptive English prompts detailing the subject, action, and desired style.
- Structure: Subject + Action/Context + Art Style + Lighting/Color.
- Negative Prompt: Supported to help exclude unwanted elements.
Parameters
- Aspect Ratio: Supports standard ratios (1:1, 16:9, 9:16, 4:3, 3:4).
- Resolution: Supports standard high resolutions (e.g., 1024x1024).
- Steps: Configurable for balancing speed and detail.
Pricing
Billing is based on the number of images generated.
- Billing Logic: Per-image generation cost.
- Tier: "Plus" tier offers a cost-effective solution for high-quality generation, positioned between standard and flagship (Max) tiers.
How to Use
- Enter Prompt: Provide a descriptive text prompt for the image.
- Configure Settings: Select aspect ratio and other generation parameters.
- Generate: Submit the request to the Qwen-Image Plus model.
- Review: View the generated image and iterate if necessary.
Best Practices
- Descriptive Prompts: Provide sufficient detail about the main subject and background.
- Style Keywords: Use specific style terms (e.g., "cyberpunk," "watercolor," "studio photo") to guide the aesthetic.
- Iterative Refinement: Start with a core idea and add details to the prompt to refine the output.
Limitations
- Complex Scenes: May occasionally struggle with highly complex multi-subject compositions compared to the Max model.
- Fine Details: Extremely intricate textures or small details might be less defined than in the Max version.
Version
- Model: Alibaba Qwen-Image Text-to-Image Plus
- Family: Qwen-Image
- Technical Context: Advanced diffusion model optimized for a balance of quality and performance.






