شروع کنید

مقدمه

API MiniToolAI یک رابط ساده برای مدل‌های هوش مصنوعی پیشرفته در پردازش زبان طبیعی، تولید تصویر، تبدیل متن به گفتار ارائه می‌دهد. این راهنما را دنبال کنید تا یاد بگیرید چگونه پاسخ‌های مشابه انسان (ChatGPT) ایجاد کنید، تصویر را از توضیحات متنی تولید کنید.

ایجاد کلید API

sk-*************   برای ایجاد کلید API وارد شوید

افزایش اعتبار

هزینه درخواست‌های API از موجودی اعتبار شما کسر خواهد شد.

افزایش اعتبار

احراز هویت

کلید API باید در هدر هر درخواست API گنجانده شود.

Header: "Authorization: Bearer API_key"

 

 

 

 

API ChatGPT

یک پاسخ مدل برای مکالمه ارائه شده ایجاد می‌کند.

Python PHP
import requests
import json
API_Url = "https://minitoolai.com/api/chat-completions/"
API_Key = "MiniToolAI_API_Key"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_Key}"
}
data = {
    "model": "gpt-4o-mini", #gpt-4o, gpt-4.1, gpt-4.1-mini, gpt-4.1-nano
    "messages": [
		{"role": "developer", "content": "You are a helpful assistant."},
		{"role": "user", "content": "Hello"},
		{"role": "assistant", "content": "How can I help you today?"},
		{"role": "user", "content": "What's the largest U.S. state by area?"}
    ],
	"temperature": 1.0,
	"max_completion_tokens": 1000
}

response = requests.post(API_Url, headers=headers, json=data, stream=True)

#single result
print(response.text) 

#streamed
for line in response.iter_lines():
    if line:
        decode_line = line.decode('utf-8')
        print(decode_line)
<?php

$api_url = "https://minitoolai.com/api/chat-completions/";
$api_key = "MiniToolAI_API_Key"; 

$data = [
    "model" => "gpt-4o-mini", //gpt-4o, gpt-4.1, gpt-4.1-mini, gpt-4.1-nano
    "messages" => [
        ["role" => "developer", "content" => "You are a helpful assistant."],
        ["role" => "user", "content" => "Hello"],
        ["role" => "assistant", "content" => "How can I help you today?"],
        ["role" => "user", "content" => "What's the largest U.S. state by area?"],
    ],
    "temperature" => 1.0,
    "max_completion_tokens" => 1000
];

$headers = [
    "Content-Type: application/json",
    "Authorization: Bearer $api_key"
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, false); 
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

// streamed
curl_setopt($ch, CURLOPT_WRITEFUNCTION, function($ch, $data) {
    echo $data;
    ob_flush(); 
    flush();     
    return strlen($data); 
});

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo "cURL error: " . curl_error($ch);
} 

curl_close($ch);

?>
#data with image input
data = {
    "model": "gpt-4o-mini", #gpt-4o
    "messages": [
        {"role": "developer", "content": "You are a helpful assistant."},
        {
            "role": "user", 
            "content": [
                {"type": "text", "text": "What's in this image?"},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://example.com/image.jpg", #jpg, jpeg, png, webp or gif
                        "detail": "auto" #auto, high or low
                    }
                }
            ]
        }

    ],
    "temperature": 0.7,
    "max_completion_tokens": 300
}
//data with image input
$data = [
    "model" => "gpt-4o-mini", // gpt-4o
    "messages" => [
        ["role" => "developer", "content" => "You are a helpful assistant."],
        [
            "role" => "user",
            "content" => [
                [
                    "type" => "text",
                    "text" => "What's in this image?"
                ],
                [
                    "type" => "image_url",
                    "image_url" => [
                        "url" => "https://example.com/image.jpg", // jpg, jpeg, png, webp or gif
                        "detail" => "auto" // auto, high or low
                    ]
                ]
            ]
        ]
    ],
    "temperature" => 0.7,
    "max_completion_tokens" => 300
];

بدنه درخواست

messages آرایه الزامی

فهرستی از پیام‌ها که مکالمه تا کنون را تشکیل می‌دهد.

  • Developer message: دستورالعمل‌هایی که توسعه‌دهنده ارائه کرده و مدل باید از آن‌ها پیروی کند، صرف‌نظر از پیام‌های ارسال شده توسط کاربر.
  • User message: پیام‌های ارسال شده توسط کاربر نهایی، شامل درخواست‌ها یا اطلاعات زمینه‌ای اضافی.
  • Assistant message: پیام‌های ارسال شده توسط مدل در پاسخ به پیام‌های کاربر.

model رشته الزامی

شناسه مدل مورد استفاده

مدل‌های موجود: gpt-4o, gpt-4o-mini, gpt-4.1, gpt-4.1-mini, gpt-4.1-nano

temperature عدد یا مقدار null اختیاری

پیش‌فرض 1

دمای نمونه‌گیری مورد استفاده بین 0.0 و 2.0. مقادیر بالاتر مانند 0.8 خروجی را خلاقانه‌تر می‌کند، در حالی که مقادیر پایین‌تر مانند 0.2 آن را متمرکزتر و قطعی‌تر می‌کند.

max_completion_tokens عدد صحیح یا مقدار null اختیاری

پیش‌فرض 1000

حد بالای تعداد توکن‌هایی که می‌توانند برای یک تکمیل تولید شوند.

پاسخ

data: {"id":"chatcmpl-B5qoZsT8kFDNJK3UyGLiJmjv6Pp90","object":"chat.completion.chunk","created":1740734359,"model":"gpt-4o-mini-2024-07-18","service_tier":"default","system_fingerprint":"fp_06737a9306","choices":[{"index":0,"delta":{"content":"Ok"},"logprobs":null,"finish_reason":null}],"usage":null}

data: {"id":"chatcmpl-B5qoZsT8kFDNJK3UyGLiJmjv6Pp90","object":"chat.completion.chunk","created":1740734359,"model":"gpt-4o-mini-2024-07-18","service_tier":"default","system_fingerprint":"fp_06737a9306","choices":[{"index":0,"delta":{"content":"."},"logprobs":null,"finish_reason":null}],"usage":null}

data: {"id":"chatcmpl-B5qoZsT8kFDNJK3UyGLiJmjv6Pp90","object":"chat.completion.chunk","created":1740734359,"model":"gpt-4o-mini-2024-07-18","service_tier":"default","system_fingerprint":"fp_06737a9306","choices":[{"index":0,"delta":{},"logprobs":null,"finish_reason":"stop"}],"usage":null}

data: {"id":"chatcmpl-B5qoZsT8kFDNJK3UyGLiJmjv6Pp90","object":"chat.completion.chunk","created":1740734359,"model":"gpt-4o-mini-2024-07-18","service_tier":"default","system_fingerprint":"fp_06737a9306","choices":[],"usage":{"prompt_tokens":17,"completion_tokens":3,"total_tokens":20,"prompt_tokens_details":{"cached_tokens":0,"audio_tokens":0},"completion_tokens_details":{"reasoning_tokens":0,"audio_tokens":0,"accepted_prediction_tokens":0,"rejected_prediction_tokens":0}}}

data: [DONE]

 

 

 

 

تبدیل متن به تصویر

تصویری را بر اساس یک درخواست ایجاد می‌کند.

Python PHP
import requests
import json
url = "https://minitoolai.com/api/texttoimage/"
API_Key = "MiniToolAI_API_Key"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_Key}"
}
data = {
    "model": "realvision",
    "prompt": "Ultra realistic portrait of a 20 year old woman, wearing an elegant black gown, joyful expression, deep shadows, cinematic composition, moody lighting",
    "negativePrompt": "unrealistic eyes, malformed features, ugly drawn",
    "scheduler": "DPM++ SDE",
    "steps": 4,
    "cfgScale": 2.0,
    "width": 1152,
    "height": 768
}
response = requests.post(url, json=data, headers=headers)
print(response.text)

'''
#response
Success:
{"status":"success","jobid":12345678,"signature":"abcxyz123"}
Error:
{"status":"error","jobid":null,"signature":null}
'''
<?php
// API URL and Key
$url = "https://minitoolai.com/api/texttoimage/";
$API_Key = "MiniToolAI_API_Key";

// Headers
$headers = [
    "Content-Type: application/json",
    "Authorization: Bearer $API_Key"
];

// Data to be sent in the request
$data = [
    "model" => "realvision",
    "prompt" => "Ultra realistic portrait of a 20 year old woman, wearing an elegant black gown, joyful expression, deep shadows, cinematic composition, moody lighting",
    "negativePrompt" => "unrealistic eyes, malformed features, ugly drawn",
    "scheduler" => "DPM++ SDE",
    "steps" => 4,
    "cfgScale" => 2.0,
    "width" => 1152,
    "height" => 768
];

// Initialize cURL session
$ch = curl_init();

// Set cURL options
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

// Execute the cURL request
$response = curl_exec($ch);

echo $response;

// Close the cURL session
curl_close($ch);

/*
Response:
Success:
{"status":"success","jobid":12345678,"signature":"abcxyz123"}
Error:
{"status":"error","jobid":null,"signature":null}
*/
?>

بازیابی وضعیت و نتیجهٔ کار

curl -X POST https://minitoolai.com/api/texttoimage/jobs/ \
  -H "Content-Type: application/json" \
  -d '{
    "jobid": "12345678",
    "signature": "abcxyz123"
  }'

پاسخ

{
  "status": "success",
  "image_url": "https://...",
  "message": "success"
}

model رشته الزامی

شناسه مدل مورد استفاده

مدل‌های موجود: "realvision", "juggernaut", "autismmix", "dreamshaper", "valhalla", "mixrealistic", "campursari", "reality", "extrarealistic", "realism", "realgirls", "realityreborn", "amigo", "simplemix", "beautifulrealistic"

prompt رشته الزامی

توضیح تصویر

negativePrompt رشته یا مقدار null اختیاری

توضیح اینکه چه چیزی را نمی‌خواهید در تصویر ایجاد شده گنجانده شود.

scheduler رشته یا مقدار null اختیاری

کنترل میزان نویز حذف شده در طول فرآیند تولید تصویر.

پیش‌فرض "DPM++ SDE"

مقادیر ممکن عبارتند از: "Euler a", "Euler", "LMS", "Heun", "DPM2", "DPM2 a", "DPM++ 2S a", "DPM++ 2M", "DPM++ SDE", "DPM++ 2M SDE", "DPM fast", "LMS Karras", "DPM2 Karras", "DPM2 a Karras", "DPM++ 2S a Karras", "DPM++ 2M Karras", "DPM++ SDE Karras", "DPM++ 2M SDE Karras"

steps عدد صحیح یا مقدار null اختیاری

تعداد مراحل برای فرایند تولید تصویر، بین ۱ تا ۸.

پیش‌فرض 4

cfgScale عدد یا مقدار null اختیاری

cfgScale مشخص می‌کند مدل تا چه حد باید به متن ورودی پایبند باشد. بین خلاقیت و دقت نسبت به ورودی تعادل ایجاد می‌کند (بین ۱ تا ۷).

پیش‌فرض 2

cfgScale < 4 → تصاویر خلاقانه‌تر, cfgScale > 4 → نزدیک‌تر به درخواست، کمتر خلاقانه

width/height عدد صحیح یا مقدار null اختیاری

اندازه تصویر تولید شده، بین 256 تا 1344.

پیش‌فرض 1024

 

 

 

 

قیمت‌گذاری API

مدل‌های GPT

قیمت به ازای 1M توکن

مدل ورودی خروجی
gpt-4o-mini $0.15 $0.60
gpt-4o $2.50 $10.00
gpt-4.1 $2.00 $8.00
gpt-4.1-mini $0.40 $1.60
gpt-4.1-nano $0.10 $0.40

تولید تصویر

مدل قیمت به‌ازای هر تصویر
همه مدل‌ها $0.0015

 

 

 

 

مصرف API

برای مشاهده مصرف API وارد شوید

تولید متن

تولید تصویر