ویرایش عکس با هوش مصنوعی

با استفاده از این وب سرویس میتوانید عکس های مختلف را با استفاده از هوش مصنوعی ویرایش کنید.

مشخصات

مشخصه	مقدار
دسته‌بندی	هوش مصنوعی
وضعیت	فعال
نسخه API	apis-2
فرمت پاسخ	JSON
آدرس پایه	https://open.nestapi.ir
مسیر	/apis-2/edit-image
لینک کامل	https://open.nestapi.ir/apis-2/edit-image

متدهای HTTP

متد	مسیر	نوع ورودی
GET	/apis-2/edit-image	Query String

پارامترها

پارامترهای Query String

نام	نوع	الزامی	پیش‌فرض	توضیحات
url	string	بله	—	لینک تصویر مورد نظر
prompt	string	بله	—	توضیحات یا دستورات برای ویرایش عکس

نمونه درخواست

لینک مستقیم

GET https://open.nestapi.ir/apis-2/edit-image?url=https://open.nestapi.ir/storage/nestapi-photo-1.jpeg&prompt=%D9%88%DB%8C%D8%B1%D8%A7%DB%8C%D8%B4%20%D8%A8%DA%A9%DA%AF%D8%B1%D8%A7%D9%86%D8%AF%20%D8%A8%D9%87%20%D8%AC%D9%86%DA%AF%D9%84

نمونه کد

cURL

curl -X GET "https://open.nestapi.ir/apis-2/edit-image?url=https://open.nestapi.ir/storage/nestapi-photo-1.jpeg&prompt=%D9%88%DB%8C%D8%B1%D8%A7%DB%8C%D8%B4%20%D8%A8%DA%A9%DA%AF%D8%B1%D8%A7%D9%86%D8%AF%20%D8%A8%D9%87%20%D8%AC%D9%86%DA%AF%D9%84"

PHP

<?php

// composer require nestapi/nestapi
require 'vendor/autoload.php';

use NestApi\NestApi;
use NestApi\Exception\ApiException;
use NestApi\Exception\TransportException;

$api = new NestApi(version: 2);

try {
    $response = $api->editImage(
        url: 'https://open.nestapi.ir/storage/nestapi-photo-1.jpeg',
        prompt: 'ویرایش بکگراند به جنگل',
    );

    print_r($response->data);
} catch (ApiException $e) {
    // Error reported by the API (validation, not found, rate limit, ...)
    echo $e->getMessage();
} catch (TransportException $e) {
    // Network error or unusable response; not a subclass of ApiException
    echo 'Network error: ' . $e->getMessage();
}

Python

# pip install nestapi-py
from nestapi import ApiError, NestApi, TransportError

with NestApi(version=2) as api:
    try:
        response = api.edit_image(
            url="https://open.nestapi.ir/storage/nestapi-photo-1.jpeg",
            prompt="ویرایش بکگراند به جنگل",
        )

        print(response.data)
    except ApiError as e:
        # Error reported by the API (validation, not found, rate limit, ...)
        print(e.error_code, e)
    except TransportError as e:
        # Network error or unusable response; not a subclass of ApiError
        print("Network error:", e)

JavaScript

// npm install @devh3n/nestapi
import { ApiError, NestApi, TransportError } from "@devh3n/nestapi";

const api = new NestApi({ version: 2 });

try {
  const response = await api.editImage({
    url: "https://open.nestapi.ir/storage/nestapi-photo-1.jpeg",
    prompt: "ویرایش بکگراند به جنگل",
  });

  console.log(response.data);
} catch (error) {
  if (error instanceof ApiError) {
    // Error reported by the API (validation, not found, rate limit, ...)
    console.error(error.errorCode, error.message);
  } else if (error instanceof TransportError) {
    // Network error or unusable response; not a subclass of ApiError
    console.error("Network error:", error.message);
  }
}

کدهای خطا

کد	وضعیت	علت
NOT_FOUND	404	مسیر وجود ندارد، یا متد روی آن ثبت نشده
PARAM_NOT_FOUND	400	پارامتر url یا prompt ارسال نشده
VALIDATION_ERROR	422	پارامتر آمده ولی نوع، قالب یا بازه‌اش نادرست است
INVALID_IMAGE_TYPE	422	آدرس ارسالی به فرمت تصویر پشتیبانی‌شده اشاره نمی‌کند
DOWNLOAD_FAILED	502	خطا در دانلود تصویر اصلی یا تصویر ساخته‌شده
UPLOAD_LINK_FAILED	502	خطا در دریافت لینک آپلود از سرویس تصویر
UPLOAD_FAILED	502	خطا در آپلود تصویر اصلی در سرویس ویرایش هوش مصنوعی
GENERATION_FAILED	502	ویرایش تصویر توسط هوش مصنوعی با خطا مواجه شد
NO_OUTPUT_URL	502	سرویس ویرایش آدرس تصویر خروجی را برنگرداند
HTTP_TIMEOUT	504	مهلت پاسخ سرویس ویرایش هوش مصنوعی به پایان رسید
PROCESSING_FAILED	502	خطای غیرمنتظره در پردازش تصویر

لینک های بیشتر

• راهنمای اتصال به سرویس
• فرمت خروجی موفقیت API
• فرمت خروجی خطای API
• کدهای خطای عمومی