Reve Art

เอกสารประกอบ API ของ Reve Art

ยินดีต้อนรับสู่ API การสร้างภาพของ Reve Art บริการนี้มอบความสามารถในการสร้างภาพที่ขับเคลื่อนด้วย AI ที่ล้ำสมัยผ่าน REST API ที่เรียบง่าย

บทนำสู่ Reve Image 1.0

Reve Image 1.0 เป็นโมเดลการสร้างข้อความเป็นภาพรุ่นเรือธงของเรา ออกแบบโดยเน้นที่:

  • การปฏิบัติตามคำสั่ง (prompt) ที่เหนือกว่า
  • คุณภาพสุนทรียศาสตร์สูง
  • การแสดงผลตัวอักษรที่แม่นยำ
  • การสร้างภาพจากข้อความที่ใช้งานง่าย

โมเดลนี้ได้รับการออกแบบมาเพื่อสร้างผลลัพธ์ที่มีคุณภาพสูงโดยไม่จำเป็นต้องมีความเชี่ยวชาญด้านวิศวกรรมคำสั่ง (prompt engineering) ขั้นสูง ทำให้ผู้เริ่มต้นและผู้ใช้ที่มีประสบการณ์สามารถเข้าถึงได้ คุณสามารถทดลองใช้ได้ฟรีที่ สร้างภาพ

กรณีการใช้งาน

Reve Art API สามารถรวมเข้ากับแอปพลิเคชันต่างๆ ได้:

  • การสร้างเนื้อหา: สร้างภาพที่ไม่ซ้ำใครสำหรับบล็อก บทความ และโซเชียลมีเดีย
  • อีคอมเมิร์ซ: สร้างภาพจำลองและรูปแบบผลิตภัณฑ์
  • การออกแบบและการสร้างต้นแบบ: มองเห็นแนวคิดการออกแบบได้อย่างรวดเร็ว
  • เกมและความบันเทิง: สร้างสินทรัพย์เกมและการออกแบบตัวละคร
  • การศึกษา: สร้างสื่อการศึกษาและภาพประกอบ

การตรวจสอบสิทธิ์

คำขอ API ทั้งหมดต้องมีการตรวจสอบสิทธิ์โดยใช้ API key

เพิ่ม API key ไปยังส่วนหัว (header) Authorization:

bash
curl -X POST https://reve-art.com/v1/reve-image/generate \
-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{"prompt": "your prompt here", "aspect_ratio": "1:1"}'

วิธีรับ API Key

โปรดเข้าสู่ระบบและเพิ่ม api-key ของคุณในหน้า Dashboard > API Key

จากนั้นใช้ api-key เพื่อสร้างภาพ

สร้างภาพ

ปลายทางการสร้างภาพช่วยให้คุณสร้างภาพจากคำอธิบายที่เป็นข้อความ คุณสามารถควบคุมด้านต่างๆ ของกระบวนการสร้างผ่านพารามิเตอร์ต่างๆ

แนวทางปฏิบัติที่ดีที่สุด

  1. Prompt Engineering

    • ระบุและบรรยายในคำสั่งของคุณให้ชัดเจน
    • ใช้คำศัพท์ศิลปะเพื่อเป็นแนวทางด้านสไตล์
    • รวมรายละเอียดเกี่ยวกับแสง มุมมอง และอารมณ์

  2. การเลือกอัตราส่วนภาพ

    • เลือกตามกรณีการใช้งานที่คุณต้องการ
    • 1:1 สำหรับโพสต์บนโซเชียลมีเดีย
    • 16:9 สำหรับการนำเสนอ/แบนเนอร์
    • 9:16 สำหรับเนื้อหามือถือ

  3. การสร้างแบบ Asynchronous

    • ใช้ async=true สำหรับการสร้างที่นานขึ้น
    • ใช้การสำรวจสถานะ (status polling) เพื่อประสบการณ์การใช้งานที่ดีขึ้น

POST /v1/images/generate

เนื้อหาการร้องขอ (Request Body)

{
  "prompt": "string",           // จำเป็น: คำสั่งการสร้างภาพ
  "negative_prompt": "string",  // ไม่จำเป็น: สิ่งที่ไม่ควรมีในภาพ
  "aspect_ratio": "string",    // จำเป็น: อัตราส่วนภาพ (ค่าเริ่มต้น: "1:1")
  "async": boolean             // ไม่จำเป็น: การสร้างแบบ Asynchronous (ค่าเริ่มต้น: false)
}

อัตราส่วนภาพ

อัตราส่วนภาพของภาพ อัตราส่วนที่รองรับ: "1:1", "16:9", "4:3", "3:4", "9:16", "2:3", "3:2"

การตอบสนองแบบ Synchronous

{
  "id": "img_123",
  "status": "completed",
  "url": "https://cdn.reve-art.com/img_123.png",
  "metadata": {
    "prompt": "your prompt",
    "width": 1024,
    "height": 1024,
    "created_at": "2024-01-01T00:00:00Z"
  }
}

การตอบสนองแบบ Asynchronous

{
  "id": "img_123",
  "status": "pending"
}

ตัวอย่างการใช้งาน

Python:

import requests

api_key = "your_api_key"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.reve-art.com/v1/reve-image/generate",
    headers=headers,
    json={
        "prompt": "a beautiful sunset over mountains",
        "aspect_ratio": "16:9"
    }
)

if response.ok:
    result = response.json()
    print(f"Image URL: {result['url']}")
else:
    print(f"Error: {response.text}")

Node.js:

async function generateImage(prompt: string) {
  const response = await fetch("https://api.reve-art.com/v1/reve-image/generate", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      prompt,
      aspect_ratio: "1:1",
      async: true,
    }),
  });

  if (!response.ok) {
    throw new Error(`Failed to generate image: ${response.statusText}`);
  }

  const result = await response.json();
  
  if (result.status === "pending") {
    // Poll for completion
    return await checkImageStatus(result.id);
  }

  return result;
}

ตรวจสอบสถานะภาพ

GET /v1/reve-image/status/image_id

การตอบสนอง

{
  "id": "img_123",
  "status": "completed",
  "url": "https://cdn.reve-art.com/img_123.png",
  "metadata": {
    "prompt": "original prompt",
    "width": 1024,
    "height": 1024,
    "model": "text2image_v1",
    "created_at": "2024-01-01T00:00:00Z"
  }
}

ตัวอย่างการใช้งาน

async function checkImageStatus(imageId: string) {
  const response = await fetch(
    `https://reve-art.com/v1/reve-image/status/${imageId}/`,
    {
      headers: {
        "Authorization": `Bearer ${apiKey}`,
      },
    }
  );

  if (!response.ok) {
    throw new Error(`Failed to check status: ${response.statusText}`);
  }

  return await response.json();
}

อัตราการเรียกใช้งาน (Rate Limits)

คำขอ API จะถูกจำกัดโดยแผนการสมัครสมาชิกและเครดิตที่คุณมี