기사 API - AI 기반 콘텐츠 생성 및 검증

브리프에서 SEO 최적화 기사를 생성하고 AI 기반 분석으로 콘텐츠 품질을 검증합니다. 콘텐츠 마케팅, 블로그 자동화 및 편집 워크플로에 적합합니다.

무엇을 할 수 있나요?
AI 기사 생성

간단한 설명에서 출판 가능한 기사를 만듭니다.

품질 검증

가독성, 문법, 구조 및 SEO 준수를 위해 기사를 분석합니다.

SEO 최적화

검색 엔진과 AI 검색 플랫폼에 최적화된 콘텐츠를 생성합니다.

99.9 % 가동 시간
8302ms 응답
20 req/s
10 크레딧 / 요청

Generate Article

Generate a complete, publication-ready article from a brief description. Supports multiple formats, writing tones, SEO optimization, and human-like writing levels.

POST https://api.yeb.to/v1/article/generate
매개변수 유형 필수 설명
api_key string Authentication key
brief string Description of the article to generate (max 250 words)
title string 선택 Article title (auto-generated if empty)
format string 선택 Output format: markdown, html, json, plain_text
Default: markdown
length integer 선택 Target word count (100-10000)
Default: 1500
niche string 선택 Topic niche: technology, marketing, lifestyle, finance, health, business, general
tone string 선택 Writing tone: neutral, formal, casual, professional, friendly, authoritative, conversational
style string 선택 Writing style: first_person, third_person, commentary, article, opinion, guide, tutorial
optimization string 선택 SEO focus: seo, ai_search, both, none
Default: both
keywords object 선택 Keyword hints:
{"whitelist":["keyword1"], "blacklist":["avoid"], "neutral":["optional"]}
Keywords are hints, not strict requirements
allowed_elements object 선택 HTML/Markdown elements to use:
{"h2":true, "h3":true, "bullets":true, "bold":true, "italic":true}
human_like string 선택 Human-like writing level: low, medium, high
Default: high
temperature float 선택 AI creativity (0.0-2.0)
Default: 0.7
top_p float 선택 Diversity control (0.0-1.0)
Default: 0.9
presence_penalty float 선택 Topic repetition penalty (-2.0 to 2.0)
Default: 0.6
frequency_penalty float 선택 Word repetition penalty (-2.0 to 2.0)
Default: 0.5

요청 예시

Example 1: Basic article generation
{
  "api_key": "YOUR_KEY",
  "brief": "Write about the benefits of remote work for software developers",
  "length": 1500
}
Example 2: SEO-optimized blog post
{
  "api_key": "YOUR_KEY",
  "brief": "Complete guide to container orchestration with Kubernetes",
  "title": "Kubernetes 101: From Zero to Production",
  "format": "markdown",
  "length": 3000,
  "niche": "technology",
  "tone": "professional",
  "style": "tutorial",
  "optimization": "seo",
  "keywords": {
    "whitelist": ["Kubernetes", "container orchestration", "DevOps"],
    "blacklist": ["deprecated", "legacy"]
  }
}
Example 3: Casual lifestyle article
{
  "api_key": "YOUR_KEY",
  "brief": "Tips for maintaining work-life balance while working from home",
  "format": "html",
  "length": 1200,
  "niche": "lifestyle",
  "tone": "friendly",
  "style": "first_person",
  "human_like": "high"
}
Example 4: All parameters
{
  "api_key": "YOUR_KEY",
  "brief": "In-depth analysis of AI impact on content marketing",
  "title": "AI in Content Marketing: A 2025 Perspective",
  "format": "markdown",
  "length": 2500,
  "niche": "marketing",
  "tone": "authoritative",
  "style": "article",
  "optimization": "both",
  "keywords": {
    "whitelist": ["AI content", "marketing automation"],
    "blacklist": ["spam", "clickbait"],
    "neutral": ["digital marketing", "ROI"]
  },
  "allowed_elements": {
    "h2": true,
    "h3": true,
    "bullets": true,
    "bold": true,
    "italic": true
  },
  "temperature": 0.7,
  "top_p": 0.9,
  "presence_penalty": 0.6,
  "frequency_penalty": 0.5,
  "human_like": "high"
}

API 연동

curl -X POST https://api.yeb.to/v1/article/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "brief": "Write about cloud cost optimization strategies",
    "length": 2000,
    "niche": "technology",
    "tone": "professional",
    "optimization": "seo"
  }'
$response = Http::withHeaders([
    'X-API-Key' => 'YOUR_KEY'
])->post('https://api.yeb.to/v1/article/generate', [
    'brief' => 'Write about cloud cost optimization strategies',
    'length' => 2000,
    'niche' => 'technology',
    'tone' => 'professional',
    'optimization' => 'seo',
    'keywords' => [
        'whitelist' => ['cloud costs', 'AWS', 'optimization']
    ]
]);

$article = $response->json()['article'];
echo $article['title'];
echo $article['content'];
fetch('https://api.yeb.to/v1/article/generate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_KEY'
  },
  body: JSON.stringify({
    brief: 'Write about cloud cost optimization strategies',
    length: 2000,
    niche: 'technology',
    tone: 'professional',
    optimization: 'seo'
  })
})
.then(r => r.json())
.then(data => {
  console.log(data.article.title);
  console.log(data.article.content);
});
import requests

response = requests.post(
    'https://api.yeb.to/v1/article/generate',
    headers={'X-API-Key': 'YOUR_KEY'},
    json={
        'brief': 'Write about cloud cost optimization strategies',
        'length': 2000,
        'niche': 'technology',
        'tone': 'professional',
        'optimization': 'seo',
        'keywords': {
            'whitelist': ['cloud costs', 'AWS', 'optimization']
        }
    }
)
article = response.json()['article']
print(article['title'])
print(article['content'])

Response Example

{
  "article": {
    "title": "Cloud Cost Optimization: A Complete Guide",
    "content": "# Cloud Cost Optimization\n\n## Introduction\n\nCloud computing has revolutionized...",
    "format": "markdown",
    "word_count": 2034,
    "reading_time_minutes": 8
  },
  "response_code": 200,
  "response_time_ms": 15234
}
{
  "error": "brief is required",
  "code": 422,
  "response_code": 422,
  "response_time_ms": 12
}

응답 코드

코드설명
200 Success요청 처리 완료.
400 Bad Request입력 유효성 검사 실패.
401 UnauthorizedAPI 키 누락 또는 오류.
403 Forbidden키 비활성 또는 허용되지 않음.
429 Rate Limit요청이 너무 많습니다.
500 Server Error예기치 않은 오류.
Quick Reference
Output Formats:
  • markdown - Default, with # headings
  • html - Full HTML with tags
  • json - Structured JSON output
  • plain_text - No formatting
Writing Tones:
  • neutral - Balanced, objective
  • formal - Academic, professional
  • casual - Relaxed, conversational
  • professional - Business-appropriate
  • friendly - Warm, approachable
  • authoritative - Expert, confident
Niches:
  • technology, marketing
  • lifestyle, finance
  • health, business
  • general (default)

Generate Article

article-generate 10.0000 credits

Parameters

API Key
body · string · required
Brief
body · string · required
Title
body · string
Format
body · string
Length
body · string
Niche
body · string
Tone
body · string
Style
body · string
Temperature
body · string
Optimization
body · string
Keywords
body · string
Allowed Elements
body · string
Presence Penalty
body · string
Frequency Penalty
body · string
Human-Like
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

Validate Article

Validate an article for quality, readability, grammar, structure, and compliance with requirements. Returns detailed scores and actionable recommendations.

POST https://api.yeb.to/v1/article/validate
매개변수 유형 필수 설명
api_key string Authentication key
article_content string The article text to validate
details object 선택 Validation criteria object:
requirements - specific requirements to check
expected_length - target word count
format - expected format (markdown/html)
niche - topic niche
tone - expected tone
style - expected style
optimization - SEO requirements
keywords - keyword requirements
allowed_elements - formatting requirements

요청 예시

Example 1: Basic validation
{
  "api_key": "YOUR_KEY",
  "article_content": "# Cloud Computing Benefits\n\nCloud computing has revolutionized the way businesses operate..."
}
Example 2: Validation with niche and length requirements
{
  "api_key": "YOUR_KEY",
  "article_content": "# Cloud Computing Benefits\n\nCloud computing has revolutionized...",
  "details": {
    "niche": "technology",
    "expected_length": 1500,
    "tone": "professional"
  }
}
Example 3: Full validation with all criteria
{
  "api_key": "YOUR_KEY",
  "article_content": "# Cloud Computing Benefits\n\nCloud computing has revolutionized...",
  "details": {
    "requirements": "Must cover cost savings, scalability, and security",
    "expected_length": 2000,
    "format": "markdown",
    "niche": "technology",
    "tone": "professional",
    "style": "guide",
    "optimization": "seo",
    "keywords": {
      "whitelist": ["cloud computing", "scalability", "cost savings"],
      "blacklist": ["outdated", "legacy"]
    },
    "allowed_elements": {
      "h2": true,
      "h3": true,
      "bullets": true
    }
  }
}

API 연동

curl -X POST https://api.yeb.to/v1/article/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "article_content": "# My Article\n\nThis is the content...",
    "details": {
      "niche": "technology",
      "expected_length": 1500
    }
  }'
$response = Http::withHeaders([
    'X-API-Key' => 'YOUR_KEY'
])->post('https://api.yeb.to/v1/article/validate', [
    'article_content' => $articleText,
    'details' => [
        'niche' => 'technology',
        'expected_length' => 1500,
        'tone' => 'professional',
        'keywords' => [
            'whitelist' => ['cloud', 'scalability']
        ]
    ]
]);

$validation = $response->json();

if ($validation['validation_passed']) {
    echo "Article passed validation!";
    echo "Quality score: " . $validation['overall_quality_rate'];
} else {
    echo "Issues found:";
    foreach ($validation['issues'] as $issue) {
        echo "- " . $issue;
    }
}
fetch('https://api.yeb.to/v1/article/validate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_KEY'
  },
  body: JSON.stringify({
    article_content: articleText,
    details: {
      niche: 'technology',
      expected_length: 1500,
      tone: 'professional'
    }
  })
})
.then(r => r.json())
.then(data => {
  console.log('Quality:', data.overall_quality_rate);
  console.log('Passed:', data.validation_passed);
  console.log('Recommendations:', data.recommendations);
});
import requests

response = requests.post(
    'https://api.yeb.to/v1/article/validate',
    headers={'X-API-Key': 'YOUR_KEY'},
    json={
        'article_content': article_text,
        'details': {
            'niche': 'technology',
            'expected_length': 1500,
            'tone': 'professional',
            'keywords': {
                'whitelist': ['cloud', 'scalability']
            }
        }
    }
)

validation = response.json()
print(f"Quality: {validation['overall_quality_rate']}")
print(f"Passed: {validation['validation_passed']}")

for rec in validation['recommendations']:
    print(f"- {rec}")

Response Example

{
  "overall_quality_rate": 0.85,
  "sensitive_rate": 0.05,
  "spam_score_rate": 0.12,
  "validation_passed": true,
  "scores": {
    "readability": 0.88,
    "grammar": 0.95,
    "structure": 0.82,
    "keyword_usage": 0.78,
    "originality": 0.90
  },
  "issues": [],
  "recommendations": [
    "Consider adding more H2 headings",
    "Increase keyword variations"
  ],
  "response_code": 200,
  "response_time_ms": 2340
}
{
  "error": "article_content is required",
  "code": 422,
  "response_code": 422,
  "response_time_ms": 8
}

응답 코드

코드설명
200 Success요청 처리 완료.
400 Bad Request입력 유효성 검사 실패.
401 UnauthorizedAPI 키 누락 또는 오류.
403 Forbidden키 비활성 또는 허용되지 않음.
429 Rate Limit요청이 너무 많습니다.
500 Server Error예기치 않은 오류.
Score Reference
Overall Scores (0.0 - 1.0):
  • overall_quality_rate - Combined quality
  • sensitive_rate - Sensitive content level
  • spam_score_rate - Spam-like content
Detailed Scores:
  • readability - Ease of reading
  • grammar - Grammar correctness
  • structure - Article structure
  • keyword_usage - Keyword optimization
  • originality - Content uniqueness
Interpretation:
  • 0.9+ - Excellent
  • 0.7-0.9 - Good
  • 0.5-0.7 - Needs improvement
  • <0.5 - Poor quality
Common Use Cases
  • Pre-publish QA: Validate before publishing
  • Content audit: Review existing articles
  • Freelancer review: Check submitted content
  • SEO compliance: Verify keyword usage

Validate Article

article-validate 5.0000 credits

Parameters

API Key
body · string · required
Article Content
body · string · required
Details
body · string

Code Samples


                
                
                
            

Response

Status:
Headers

                
Body

                

기사 API - AI 기반 콘텐츠 생성 및 검증 — Practical Guide

A comprehensive guide to the Article API: generate high-quality, SEO-optimized articles using AI and validate existing content for quality, readability, and compliance. Perfect for content platforms, marketing automation, blog management, and editorial workflows.

#What Article API solves

The Article API provides 2 powerful endpoints for AI-powered content creation and validation: generate complete, SEO-optimized articles from a brief, and validate existing content for quality metrics. Supports multiple output formats, writing tones and styles, keyword optimization, and human-like writing levels. Perfect for content marketing, blog automation, editorial workflows, and quality assurance.

#Available endpoints

#POST /v1/article/generate

  • Best for: Creating complete, publication-ready articles from a brief description
  • Use case: Blog posts, marketing content, SEO articles, guides, tutorials

#POST /v1/article/validate

  • Best for: Evaluating article quality, readability, and compliance with requirements
  • Use case: Quality assurance, editorial review, content auditing, compliance checking

#Quick start

# Generate a simple article
curl -X POST "https://api.yeb.to/v1/article/generate" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brief": "Write about the benefits of remote work for software developers",
    "length": 1500
  }'
# Generate with full customization
curl -X POST "https://api.yeb.to/v1/article/generate" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brief": "Complete guide to container orchestration with Kubernetes",
    "title": "Kubernetes 101: From Zero to Production",
    "format": "markdown",
    "length": 3000,
    "niche": "technology",
    "tone": "professional",
    "style": "tutorial",
    "optimization": "both",
    "human_like": "high"
  }'
# Validate an article
curl -X POST "https://api.yeb.to/v1/article/validate" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "article_content": "Your article text here...",
    "details": {
      "niche": "technology",
      "expected_length": 1500
    }
  }'

#Key parameters explained

#Generate endpoint parameters

ParamTypeDefaultDescription
brief string Required Description of the article to generate (max 250 words)
title string Auto-generated Article title (if empty, AI generates one)
format string markdown Output: markdown, html, json, plain_text
length integer 1500 Target word count (100-10000)
niche string general Topic: technology, marketing, lifestyle, finance, health, business
tone string neutral Voice: neutral, formal, casual, professional, friendly, authoritative
style string article Format: first_person, third_person, commentary, article, opinion, guide, tutorial
optimization string both SEO focus: seo, ai_search, both, none
keywords object null Keyword config: {"whitelist":[], "blacklist":[], "neutral":[]}
human_like string high Human writing level: low, medium, high
temperature float 0.7 AI creativity (0.0-2.0)

#Validate endpoint parameters

ParamTypeDefaultDescription
article_content string Required The article text to validate
details object null Validation criteria (niche, expected_length, format, tone, style, etc.)

#Reading & handling responses

#Generate response

{
  "article": {
    "title": "The Complete Guide to Remote Work for Developers",
    "content": "# The Complete Guide to Remote Work...\n\n## Introduction\n...",
    "format": "markdown",
    "word_count": 1523,
    "reading_time_minutes": 6
  },
  "response_code": 200,
  "response_time_ms": 12456
}

#Validate response

{
  "overall_quality_rate": 0.85,
  "sensitive_rate": 0.05,
  "spam_score_rate": 0.12,
  "validation_passed": true,
  "scores": {
    "readability": 0.88,
    "grammar": 0.95,
    "structure": 0.82,
    "keyword_usage": 0.78,
    "originality": 0.90
  },
  "issues": [],
  "recommendations": [
    "Consider adding more H2 headings for better structure",
    "Increase keyword variations for better SEO"
  ],
  "response_code": 200,
  "response_time_ms": 2340
}

#Error responses

{ "error": "brief is required", "code": 422, "response_code": 422 }
{ "error": "Invalid API key", "code": 401, "response_code": 401 }
  • 401: Invalid or missing API key
  • 402: Insufficient credits
  • 422: Missing required parameters or invalid format
  • 429: Rate limit exceeded
  • 500: Server error (retry with exponential backoff)

#Real-world use cases

#Automated blog content

Challenge: Generate SEO-optimized blog posts at scale
Solution: Use generate with keywords and optimization settings

POST /v1/article/generate
{
  "brief": "Write about cloud cost optimization strategies",
  "niche": "technology",
  "tone": "professional",
  "style": "guide",
  "optimization": "seo",
  "keywords": {
    "whitelist": ["cloud costs", "AWS", "cost optimization"],
    "blacklist": ["cheap", "free trial"]
  },
  "length": 2000
}

#Editorial quality assurance

Challenge: Review articles before publication
Solution: Validate content quality and compliance

// Generate article
POST /v1/article/generate {...}

// Validate before publishing
POST /v1/article/validate {
  "article_content": "Generated article content...",
  "details": {
    "niche": "technology",
    "expected_length": 2000,
    "tone": "professional"
  }
}

// Check validation_passed before publishing

#Best practices

  1. Write detailed briefs: More context = better articles. Include key points to cover.
  2. Use appropriate lengths: 1000-2000 words for blog posts, 2500-5000 for guides
  3. Match tone to audience: Professional for B2B, casual for consumer content
  4. Validate before publishing: Use the validate endpoint for quality assurance
  5. Leverage keywords wisely: Whitelist for must-include, blacklist for brand safety
  6. Set human_like to high: For content that needs to pass AI detection
  7. Handle long responses: Generation can take 10-30 seconds for long articles

#API Changelog

2025-01-21
v1.0 Launch: Article API released with generate and validate endpoints. Support for multiple formats, tones, styles, and SEO optimization.

자주 묻는 질문

우리 API는 고급 언어 모델을 사용하여 전문 출판에 적합한 고품질 인간과 유사한 콘텐츠를 생성합니다.

100단어에서 10,000단어까지 기사를 생성할 수 있습니다. 기본값은 1,500단어로 블로그 게시물과 SEO 콘텐츠에 최적입니다.

Markdown(기본값), HTML, JSON 구조화 형식 및 일반 텍스트를 지원합니다.

검증은 가독성, 문법, 구조, 키워드 사용, 독창성, 스팸 점수 및 민감한 콘텐츠 감지를 분석합니다.

예. 오류가 발생한 요청을 포함하여 모든 요청은 크레딧을 소비합니다. 크레딧은 성공 또는 실패와 관계없이 요청 수에 연결됩니다. 오류가 당사 플랫폼 문제로 인한 것이 분명한 경우 영향을 받은 크레딧을 복원합니다(현금 환불 없음).

[email protected]로 문의하세요. 피드백을 진지하게 받아들입니다—버그 리포트나 기능 요청이 의미 있는 경우 API를 빠르게 수정하거나 개선하고 감사의 표시로 50 무료 크레딧을 제공합니다.

API와 때로는 엔드포인트에 따라 다릅니다. 일부 엔드포인트는 외부 소스의 데이터를 사용하며 더 엄격한 제한이 있을 수 있습니다. 남용을 방지하고 플랫폼 안정성을 유지하기 위해 제한도 적용합니다. 각 엔드포인트의 구체적인 제한은 문서를 확인하세요.

크레딧 시스템으로 운영됩니다. 크레딧은 API 호출과 도구에 사용하는 선불, 환불 불가 단위입니다. 크레딧은 FIFO(오래된 것부터) 방식으로 소비되며 구매일로부터 12개월간 유효합니다. 대시보드에 각 구매 날짜와 만료일이 표시됩니다.

예. 구매한 모든 크레딧(소수 잔액 포함)은 구매일로부터 12개월간 유효합니다. 미사용 크레딧은 유효 기간 종료 시 자동으로 만료되어 영구 삭제됩니다. 만료된 크레딧은 복원하거나 현금 또는 기타 가치로 전환할 수 없습니다. 경과 규칙: 2025년 9월 22일 이전에 구매한 크레딧은 2025년 9월 22일에 구매한 것으로 처리되어 2026년 9월 22일에 만료됩니다(구매 시 더 이른 만료일이 명시되지 않은 한).

예—유효 기간 내에서 이월됩니다. 미사용 크레딧은 계속 사용 가능하며 구매 후 12개월 만료까지 매월 이월됩니다.

크레딧은 환불 불가입니다. 필요한 만큼만 구매하세요—나중에 언제든 충전할 수 있습니다. 플랫폼 오류로 인해 청구가 실패한 경우 조사 후 영향을 받은 크레딧을 복원할 수 있습니다. 현금 환불 없음.

가격은 달러가 아닌 크레딧으로 설정됩니다. 각 엔드포인트에는 자체 비용이 있습니다—위의 "크레딧 / 요청" 배지를 참조하세요. 항상 정확한 지출 금액을 알 수 있습니다.
← API로 돌아가기