텍스트 생성
콘텐츠 생성 서비스 중주제나 키워드를 입력하면 자연스러운 텍스트를 자동 생성합니다.
API 키 필수
HTTPS
POST
/api/v1/generate
API 설명
텍스트 생성 API는 LLM(대형 언어 모델) 기반으로 다양한 형태의 텍스트 콘텐츠를 자동 생성합니다.
- 블로그/기사 작성
- 제품 설명 자동 작성
- 이메일 초안 생성
- 창작 글쓰기 지원
- 톤/스타일 조절 가능
사용 가이드
## 사용 방법
### 요청
```http
POST /api/v1/generate
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```
### 요청 파라미터
| 필드명 | 타입 | 필수 | 설명 |
| :--- | :---: | :---: | :--- |
| prompt | String | Y | 작성을 위한 주제 또는 지시사항 |
| max_tokens | Integer | N | 생성할 최대 토큰 수 (기본 500) |
| temperature | Float | N | 창의성 조절 (0~1, 기본 0.7) |
### 응답 파라미터
| 필드명 | 타입 | 설명 |
| :--- | :---: | :--- |
| success | Boolean | API 호출 성공 여부 |
| content | String | 생성된 텍스트 내용 |
| tokens_used | Integer | 생성에 사용된 실제 토큰 수 |
### 오류 코드
| 코드 | 메시지 | 설명 |
| :--- | :--- | :--- |
| 400 | Bad Request | prompt 누락 또는 부적절한 요청 |
| 401 | Unauthorized | 유효하지 않은 API Key |
### 응답 예시
```json
{
"success": true,
"content": "생성된 결과입니다.",
"tokens_used": 150
}
```
공통 인증 헤더
X-API-Key: YOUR_API_KEY
Content-Type: application/jsoncURL 예제
curl -X POST https://engines.ai.kr/api/v1/generate \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"인공지능의 미래에 대해 3문장으로 써줘.","style":"casual"}'