INTEGRITY Документация

← Cloudflare AI Gateway / ai-gateway / usage / providers

Parallel

Parallel ↗ представляет собой веб-API, созданный специально для ИИ и обеспечивающий готовые к использованию в продакшене результаты с минимальными галлюцинациями и опорой на факты.

Конечная точка

https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/parallel

Структура URL

При отправке запросов к Parallel вы можете направить запрос на любой эндпойнт Parallel через AI Gateway, добавив путь после parallel. Например, чтобы обратиться к Tasks API по адресу /v1/tasks/runs, используйте:

https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/parallel/v1/tasks/runs

Предварительные требования

Отправляя запросы к Parallel, убедитесь, что у вас есть следующее:

Примеры

Tasks API

Tasks API ↗ позволяет создавать комплексные задачи для исследований и анализа.

Пример cURL

curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/parallel/v1/tasks/runs \
  --header 'x-api-key: {parallel_api_key}' \
  --header 'Content-Type: application/json' \
  --data '{
    "input": "Create a comprehensive market research report on the HVAC industry in the USA including an analysis of recent M&A activity and other relevant details.",
    "processor": "ultra"
  }'

Search API

Search API ↗ включает расширенный поиск с настраиваемыми параметрами.

Пример cURL

curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/parallel/v1beta/search \
  --header 'x-api-key: {parallel_api_key}' \
  --header 'Content-Type: application/json' \
  --data '{
    "objective": "When was the United Nations established? Prefer UN'\''s websites.",
    "search_queries": [
      "Founding year UN",
      "Year of founding United Nations"
    ],
    "processor": "base",
    "max_results": 10,
    "max_chars_per_result": 6000
  }'

Chat API

Chat API ↗ поддерживается через Unified Chat Completions API AI Gateway. Подробнее см. ниже:

OpenAI-совместимый эндпойнт

Вы также можете обращаться к моделям Parallel через схему OpenAI API, используя REST API. Отправляйте свои запросы на:

https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/v1/chat/completions

Укажите:


{
"model": "parallel/{model}"
}

Пример SDK для JavaScript

import OpenAI from "openai";

const apiKey = "{parallel_api_key}";
const accountId = "{account_id}";
const gatewayId = "{gateway_id}";
const baseURL = `https://gateway.ai.cloudflare.com/v1/${accountId}/${gatewayId}/compat`;

const client = new OpenAI({
	apiKey,
	baseURL,
});

try {
	const model = "parallel/speed";
	const messages = [{ role: "user", content: "Hello!" }];
	const chatCompletion = await client.chat.completions.create({
		model,
		messages,
	});
	const response = chatCompletion.choices[0].message;
	console.log(response);
} catch (e) {
	console.error(e);
}

FindAll API

FindAll API ↗ позволяет извлекать структурированные данные из сложных запросов.

Пример cURL

curl https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/parallel/v1beta/findall/ingest \
  --header 'x-api-key: {parallel_api_key}' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "Find all AI companies that recently raised money and get their website, CEO name, and CTO name."
  }'